解析器函數與系統變數非常相似,但與後者相比,前者全部要求至少傳入一個參數,所有的參數1與函數名之間均用:
而不是|
分割。
解析器函數有時會在函數名前加上#
用以與模板區分。
列表
以下表格詳細說明了王國風雲2百科可用的解析器函數,部分術語未作解釋。 {{#Widget:Heading}}
解析器函數 | 輸入 → 輸出 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
URL與標題的數據和解析 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{localurl:页面名称}} {{localurl:页面名称|查询字符串}}
|
{{localurl:Mainpage}} → /wiki/Mainpage{{localurl:Mainpage|printable=yes}} → /index.php?title=Mainpage&printable=yes
|
指定頁面的相對路徑 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{fullurl:页面名称}} {{fullurl:页面名称|查询字符串}} {{fullurl:跨wiki前缀:远程页面名称|查询字符串}}
|
{{fullurl:Category:帮助}} → https://ck2.parawikis.com/wiki/Category:%E5%B8%AE%E5%8A%A9{{fullurl:Category:帮助|action=edit}} → https://ck2.parawikis.com/index.php?title=Category:%E5%B8%AE%E5%8A%A9&action=edit{{fullurl:mw:MediaWiki/zh|action=edit}} → https://www.mediawiki.org/wiki/MediaWiki/zh?action=edit{{fullurl:mw:Help:Magic words|action=edit}} → https://www.mediawiki.org/wiki/Help:Magic_words?action=edit
|
指定頁面的相對協議路徑,該解析器函數也能識別跨wiki前綴。 注意:未被方括號包裹起來的相對協議路徑不會自動生成為連結 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{canonicalurl:页面名称}} {{canonicalurl:页面名称|查询字符串}} {{canonicalurl:interwiki:远程页面名称|查询字符串}}
|
{{canonicalurl:Category:帮助}} → https://ck2.parawikis.com/wiki/Category:%E5%B8%AE%E5%8A%A9{{canonicalurl:Category:帮助|action=edit}} → https://ck2.parawikis.com/index.php?title=Category:%E5%B8%AE%E5%8A%A9&action=edit{{canonicalurl:mw:Help:Magic words|action=edit}} → https://www.mediawiki.org/wiki/Help:Magic_words?action=edit
|
指定頁面的絕對協議路徑,該解析器函數也能識別跨wiki前綴。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{filepath:文件名称}} {{filepath:文件名称|nowiki}} {{filepath:文件名称|缩略图大小}}
|
{{filepath:Box-1.png}} → {{filepath:Box-1.png|120}} → {{filepath:Box-1.png|nowiki}} →
|
指定文件的絕對協議路徑,可以指定縮略圖大小(僅能指定寬度大小,單位為px),也可以指定是否被直接渲染為圖片 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{urlencode:字符串}} {{urlencode:字符串|QUERY}} 、{{urlencode:字符串|WIKI}} 、{{urlencode:字符串|PATH}}
|
{{urlencode:a/b c}} 、{{urlencode:a/b c|QUERY}} → a%2Fb+c{{urlencode:a/b c|WIKI}} → a/b_c{{urlencode:a/b c|PATH}} → a%2Fb%20c
|
輸出指定字符串經編碼後的結果。不同的參數指定不同的編碼規則,用於解析頁面標題到MediaWiki類站點連結時建議使用WIKI,解析字符串到文件名時建議使用PATH,解析字符串到搜尋引擎連結時建議使用(空)、QUERY;如果你不清楚如何選擇時,你可以到Talk:提問求助區求助 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{anchorencode:字符串}}
|
{{anchorencode:a/b c}} → a/b_c
|
輸出指定字符串經MediaWiki頁內標題連結編碼規則編碼後的結果,可用於指定內容的標題的頁內導航 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{#rel2abs: 路径}} {{#rel2abs: 路径 | 基础路径}}
|
{{#rel2abs: /quok | Help:Foo/bar/baz}} → Help:Foo/bar/baz/quok{{#rel2abs: ../../../../quok | Help:Foo/bar/baz}} → 錯誤:無效路徑深度:「Help:Foo/bar/baz/../../../../quok」(嘗試訪問根節點以上節點)
|
本函數用於以通用的命令行目錄變換格式來變換頁面路徑:
對於不合法的參數1,函數並不會直接拋出錯誤,而是嘗試剔除錯誤部分繼續工作:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{#titleparts: 要解析的标题 | 要返回的层数 | 返回部分的起始点}}
|
{{#titleparts: Talk:Foo/bar/baz/quok | 2}} → Talk:Foo/bar{{#titleparts: Talk:Foo/bar/baz/quok | 2 | 2}} → bar/baz{{#titleparts: Talk:Foo/bar/baz/quok | -2}} → Talk:Foo/bar{{#titleparts: Talk:Foo/bar/baz/quok | -1 | -2}} → baz
|
該函數用於輸出給定標題的一部分:
注意:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
名字空間 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
名字空間解析器函數{{ns:}} 返回標準名字空間的本地化名稱(萌百使用標準名稱作為本地化名稱)或自定義名字空間的名稱,參數1可以指定名字空間的ID,標準名字空間的MediaWiki標準名稱、本地(語言變種)化名,自定義名字空間的名稱:
需要注意的是:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
格式化函數 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{formatnum:未格式化的数字}} {{formatnum:已格式化的数字|R}} {{formatnum:未格式化的数字|NOSEP}}
|
簡單例子:
高級例子:
錯誤的輸入會導致無法預測的輸出,不論是否有參數2
|
參數1接受任何阿拉伯數字,按照站點默認區域數字格式用分位符號分組,將其本地化後輸出。
參數2有兩個可接受字符串:
注意:
如果你真的需要輸入一個無法保證格式正確的數字的話,你可以使用 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{#dateformat:日期}} {{#formatdate:日期}} {{#dateformat:日期|格式规则}} {{#formatdate:日期|格式规则}}
|
{{#dateformat:25 dec 2009}} → 25 dec 2009{{#formatdate:dec 25,2009|dmy}} → dec 25,2009{{#dateformat:2009-12-25|mdy}} → 12月 25, 2009{{#formatdate:2009 dec 25|ISO 8601}} → 2009 dec 25
|
參數1接受一個未格式化的日期,按照設置#顯示里的「日期格式」設置將其格式化。對於未登陸的讀者和未設置日期格式的用戶,可以通過參數2指定格式:mdy 、dmy 、ymd (輸出的字母全小寫)。如果參數1隻給出月日,那麼只有mdy 和dmy 才是有效的格式。如果未指定格式或者格式無效,那麼參數1的格式將被指定為輸出格式。如果參數1的日期格式無效,那麼函數輸出參數1的原樣。
警告:即使ISO 8601格式要求參數1的日期是公曆日期,若參數2指定ISO 8601,函數也能對那些超出通常公曆範圍的日期進行格式化。同樣,函數無法正確轉換ISO 9601格式負數年份和公園前的年份。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{lc:字符串}}
|
{{lc:DATA CENTER}} → data center
|
將字符串完全小寫化 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{lcfirst:字符串}}
|
{{lcfirst:DATA center}} → dATA center
|
將字符串首字母小寫化 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{uc:字符串}}
|
{{uc:text transform}} → TEXT TRANSFORM
|
將字符串完全大寫化 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{ucfirst:字符串}}
|
{{ucfirst:text TRANSFORM}} → Text TRANSFORM
|
將字符串首字母大寫化 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{padleft:原字符串|补足后的字符串长度}} {{padleft:原字符串|补足后的字符串长度|补足用的字符串}}
|
{{padleft:xyz|5}} → 00xyz{{padleft:xyz|5|_}} → __xyz{{padleft:xyz|5|abc}} → abxyz{{padleft:xyz|7|abc}} → abcaxyz{{padleft:xyz|2}} → xyz{{padleft:|4|xyz}} → xyzx
|
將參數1通過在左側補上參數3指定的字符串(默認為0)補足到參數2指定的長度,參數3指定的字符串可能被截斷以保證補足後的字符串長度滿足要求 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{padright:原字符串|补足后的字符串长度}} {{padright:原字符串|补足后的字符串长度|补足用的字符串}}
|
{{padright:xyz|5}} → xyz00{{padright:xyz|5|_}} → xyz__{{padright:xyz|5|abc}} → xyzab{{padright:xyz|7|abc}} → xyzabca{{padright:xyz|2}} → xyz{{padright:|4|xyz}} → xyzx
|
與{{padleft:}} 近乎一樣,只是在右邊補足
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
本地化函數 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{plural:数字|单数形式|复数形式}}
|
{{plural:0|is|are}} → are{{plural:1*1|is|are}} → is{{plural:21 mod 10|is|are}} → are{{plural:{{#expr:21 mod 10}}|is|are}} → is
|
根據參數1是單數還是複數,輸出不同的字符串:單數輸出參數2,複數輸出參數3。判斷是否單複數的標準是{{#switch: 1 | {{{1}}} | {{#expr: {{{1}}} }} = true | #defualt = false}} 。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{gender:指定用户名|男性时的文本|女性时的文本|未选择性别时的文本}} {{gender:|男性时的文本|女性时的文本|未选择性别时的文本}} {{gender:.|男性时的文本|女性时的文本|未选择性别时的文本}}
|
(根據指定用戶的設置而定) | 根據指定的用戶的設置#用戶資料的「語言」設置中的性別部分,返回該性別對應的文本。
注意:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{int:信息名称}}
|
{{int:edit}} → 編輯{{int:editsectionhint|MediaWiki}} → 編輯章節:MediaWiki
|
返回指定信息的介面語言變種翻譯。可以在MediaWiki:信息标准名(en-US)/界面语言变种 里找到,亦可以修改。
對於部分信息,可以提供參數給它們,它們可以通過$1、$2……獲取這些參數,在第二個例子裏,MediaWiki替換了$1。 這種用法相較於 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
特殊嵌入 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{:(主)名字空间页面名}}
|
(主名字空間頁面) | 通過: 將名字空間強制指定為(主),從而嵌入(主)名字空間的頁面
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{msg:与某一魔术字重名的模板名}} {{raw:与某一魔术字重名的模板名}}
|
(模板正常渲染內容) | 與{{Tempate:与某一魔术字重名的模板名}} 一樣可以避免魔術字與模板名衝突,而直接嵌入模板
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{msgnw:模板名}}
|
{{msgnw:tl}} → {{raw::www::Template:Tlx|{{{1}}}|{{{2|}}}|{{{3|}}}|{{{4|}}}|{{{5|}}}|{{{6|}}}|{{{7|}}}|{{{8|}}}|{{{9|}}}|{{{10|}}}|{{{11|}}}|{{{12|}}}|{{{13|}}}|{{{14|}}}|{{{15|}}}|{{{16|}}}|{{{17|}}}|{{{18|}}}|{{{19|}}}|{{{20|}}}|{{{21|}}}|}}<noinclude>
{{template doc}} [[Category:raw 模板]] </noinclude> |
把模板的源碼以純文本形式輸出,自帶nowiki效果 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{subst:模板名}}
|
(模板的正常渲染內容,而模板源碼在替換完參數,刪去<noinclude/> 內容後嵌入到頁面源碼中)
|
把模板的源碼嵌入到頁面源碼中,參見Help:模板#subst | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
運算與邏輯判斷 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{#expr: 数学表达式 }}
|
{{#expr: 1 and -1 }} → 1
|
本函數計算並返回數學表達式的結果,你可以使用+、-、*、/ 來進行計算。本函數將e (自然對數的底數)、pi (π)作為常數使用。本函數支持的運算符如下所示:
注意:
當表達式有誤時函數會返回一個錯誤信息,此時無法再繼續計算,請注意。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{#if: X | A | B }}
|
{{#if: X | A | B }} → A{{#if: | A | B }} → B{{#if: | A }} →
|
該函數用於條件邏輯判斷:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{#ifeq: X | Y | A | B }}
|
{{#ifeq: 1 | 0 | A | B }} → B{{#ifeq: 1 | 1 | A | B }} → A
|
該函數用於條件邏輯判斷:
註: | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{#ifexist: 《页面标题》 | A | B }}
|
{{#ifexist: Main Page | A | B }} → A{{#ifexist: 肯定不存在的标题 | A | B }} → B{{#ifexist: 肯定不存在的标题 | A }} →
|
該函數用於條件邏輯判斷:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{#ifexpr: Fx(表达式) | A | B }}
|
{{#ifexpr: 1+1 | A | B }} → A{{#ifexpr: 1-1 | A | B }} → B{{#ifexpr: 1-1 | A }} →
|
該函數用於條件邏輯判斷:
註: | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{#switch: X | Y = A | #default = B}}
|
{{#switch: 1 | 0 = A | 1 = B | #default = C }} → B |
該函數用於條件邏輯判斷:
注意:
當一個參數沒有帶有
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{#time: 格式参数 }} {{#time: 格式参数 | 时间参数 }}
|
{{#time: Y/m/d}} → 2024/12/26{{#time: Y/m/d|2017-01-04}} → 2017/01/04{{#time: Y/m/d H:i:s|+1 second}} → 2024/12/26 15:51:15
|
該函數用來輸出時間:
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
雜項 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{#language:语言代码}} {{#language:语言代码|目标语言代码}}
|
{{#language:zh-cn}} → 中文(中國大陸){{#language:zh-cn|en-us}} → 中文(中國大陸)
|
以參數2的語言代碼指定的語言(沒有則以參數1的)輸出參數1的語言代碼對應的語言全名 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{#special:特殊页面名}}
|
{{#special:watchlist}} → Special:監視列表
|
輸出指定標準名稱的特殊頁面的本地化名。
可以在函數名後加e以輸出經MediaWiki URL編碼規則編碼後的頁面名:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{#tag:标签名称|内容|属性1=属性值1|属性2=属性值2|……}}
|
{{#tag:div|右浮动|style="float: right; clear: both; padding: 1em;"}} → 右浮動
|
輸出一個元素的HTML源碼,參數1為其標籤名,參數2為其內容,參數3及之後為其屬性值對。請不要向參數1傳入自閉合標籤名,如br、img、hr等。
內容中的wikitext會在tag函數渲染之前完成渲染,並與往常一樣阻止不受信任的代碼渲染。如果內容需要為空,則參數2必須為空,而不是省略。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{#invoke:模块名|函数名|参数1|参数2|……}}
|
(根據指定模塊輸出) | Lua模塊的調用方法 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{DISPLAYTITLE:标题}} {{DISPLAYTITLE:标题|noerror}} {{DISPLAYTITLE:标题|noreplace}}
|
- | 本函數用以改變當前頁面的標題的格式做出變換,該函數無法做出修改標題的行為,只能做出例如改變大小寫、下劃線替代空格等的修改。
參數1為「noerror」或「noreplace」時,會阻止由於使用多個該函數而導致的錯誤拋出。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{DEFAULTSORT:分类索引}} {{DEFAULTSORTKEY:分类索引}} {{DEFAULTCATEGORYSORT:分类索引}} {{DEFAULTSORT:分类索引|noerror}} {{DEFAULTSORT:分类索引|noreplace}}
|
- | 本函數用以改變當前頁面在分類中的索引,比如{{DEFAULTSORT:A}} 會把頁面分到A部分下。
參數1為「noerror」或「noreplace」時,會阻止由於使用多個該函數而導致的錯誤拋出。 |