說明:魔術字

本页使用了标题或全文手工转换,现处于繁体转换模式
說明頁面

魔術字是MediaWiki軟件所識別的特定字符串,它們可以返回特定的值或觸發其他的功能:比如時間、站點設置或是頁面名稱等等。此頁面只解釋標準魔術字的用法。

魔術字有三種常規類型:

  • 狀態開關:通常寫成以兩個下劃線為前後綴的大寫單詞,例如__FOO__
  • 變量:字符被兩個大括號括起來,所有字母大寫,例如{{FOO}}。用法與模板類似。
  • 解析器函數:可以創造參數,既可以是格式{{foo:...}},也可以是{{#foo:...}}。參見Help:解析器函數Lua

變量和解析器函數可以像模板一樣使用subst:。無論這個魔術字是通過被引用的模板添加的或者被包含的系統消息中添加的,依賴頁面的魔術字均將(默認)起作用或者返回當前頁面的數據。

狀態開關

狀態開關可以控制頁面(只要受皮膚支持)的顯示方式或其他行為。它往往用於排除或加入特定的頁面內容。

文字 描述
目錄
__NOTOC__ 隱藏目錄(TOC)。
__FORCETOC__ 強制於默認位置(第一個章節標題上方,忽略__NOTOC__的設置)顯示目錄。 此魔術字對於在文章內容外展示目錄的皮膚不起作用。
__TOC__ 在魔術字的位置插入目錄(忽略__NOTOC__的設置)。 多次使用時,目錄會出現在文章中第一次出現該魔術字的位置。 此魔術字對於在文章內容外展示目錄的皮膚不起作用。
編輯
__NOEDITSECTION__ 隱藏章節標題旁的編輯鏈接。這個特別有用,當章節標題在模板中被創建時,普通的編輯鏈接將會把用戶帶到編輯模板代碼界面,這與用戶的直覺不符。 在模板中使用它將擴充對模板嵌入頁面的影響,以及任何包含在同一頁面的其他模板。
__NEWSECTIONLINK__ 在非討論頁頂端「編輯」標籤右側加入一個按鈕,用於在頁面結尾加入新的章節。
__NONEWSECTIONLINK__ 移除討論頁頂端「編輯」右側的加入新章節鏈接。
分類
__NOGALLERY__ 用於分類頁面。不顯示分類中所包含文件的縮略圖,而以普通鏈接代替。
__HIDDENCAT__ 用於分類頁面。加入後此分類成為隱藏分類,將不會顯示在上級分類其及成員頁面的分類列表中(可以通過參數設置中的選項強制顯示)。
__EXPECTUNUSEDCATEGORY__ 在分類頁面上使用,從Special:UnusedCategories中刪除分類。
語言轉換
__NOCONTENTCONVERT__
__NOCC__
在語言有不同變體時(如中文簡體和繁體),不對當前頁面進行字詞轉換。比如只顯示中文,而不是顯示大陸簡體、台灣繁體、新加坡簡體和香港繁體。
__NOTITLECONVERT__
__NOTC__
在語言有不同變體時(如中文簡體和繁體),不對當前頁面進行標題轉換(其他內容照常轉換)。
其他
__START__ 無影響。 曾用於指向不應被嵌入的注釋之後開始的數據庫消息。
__END__ 明確標記條目的結尾,來防止MediaWiki移除文末的空格。
__INDEX__ 允許搜索引擎檢索本頁(忽略$wgArticleRobotPolicies的參數設置但並無法忽略robots.txt)。服從$wgExemptFromUserRobotsControl的設定。
__NOINDEX__ 禁止搜索引擎檢索本頁(比如不可在搜索引擎列出指定頁面)。服從$wgExemptFromUserRobotsControl的設定。
__STATICREDIRECT__ 用於一些重定向頁面。當有人移動頁面並勾選「更新所有指向原標題的重新導向頁面」時,禁止MediaWiki更新本頁的重定向(需要變量$wgFixDoubleRedirects)。
來自擴展
擴展 文字 描述
Disambiguator __DISAMBIG__ 標記消歧義頁面。

變數

變量可以返回關於當前頁面、wiki站點或日期的信息。變量的語法與模板類似。其中標記為「[高開銷]」的變量會被軟件記錄,且在一個頁面中可使用的總數會被限制。

如果某一模板名與變量名重複,軟件會自動將其解釋為變量(因此若要包含Template:PAGENAME,頁面中需要寫作 {{Template:PAGENAME}} 部分情況下,添加參數會迫使解析器調用模板;例如,寫{{CURRENTDAYNAME|x}}會導致調用Template:CURRENTDAYNAME,而不是所期望的魔術字。

日期和時間

以下的變量返回當前的日期和UTC時間。

在MediaWiki與瀏覽器緩存的影響下,這些變量顯示的往往是被緩存的值,而非當前的時間。

使用這些變量會使頁面被緩存的時間變得更短,這可以通過 MagicWordFactory 設置。

日期和時間魔術字被格式化為相應的語種,取決於頁面內容語言。

變量 輸出 描述
{{CURRENTYEAR}} 2024
{{CURRENTMONTH}} 04 月(補足前導的0)
{{CURRENTMONTH1}} 4 月(無前導的0)
{{CURRENTMONTHNAME}} 4月 月份名稱
{{CURRENTMONTHNAMEGEN}} 4月 月份(屬格)
{{CURRENTMONTHABBREV}} 4月 月份(縮寫)
{{CURRENTDAY}} 19 今天是幾日(不補齊)
{{CURRENTDAY2}} 19 今天是幾日(以0補齊)
{{CURRENTDOW}} 5 周內一日(無填充),0(即星期日)到6(即星期六)
{{CURRENTDAYNAME}} 星期五 周內一日(名稱)
時間
{{CURRENTTIME}} 05:35 時間(24小時制HH:mm的格式)
{{CURRENTHOUR}} 05 時間(24小時制含前導0的數字)
其他
{{CURRENTWEEK}} 16 第幾周(數字)
{{CURRENTTIMESTAMP}} 20240419053514 YYYYMMDDHHmmss時間戳
模板链接:{{CURRENTDATE}}未必是一個魔術字,但可能是一個模板

如下變量和上列變量功能相同,但是使用的是所在服務器的時間或者$wgLocaltimezone

  • {{LOCALYEAR}}
  • {{LOCALMONTH}}
  • {{LOCALMONTH1}}
  • {{LOCALMONTHNAME}}
  • {{LOCALMONTHNAMEGEN}}
  • {{LOCALMONTHABBREV}}
  • {{LOCALDAY}}
  • {{LOCALDAY2}}
  • {{LOCALDOW}}
  • {{LOCALDAYNAME}}
  • {{LOCALTIME}}
  • {{LOCALHOUR}}
  • {{LOCALWEEK}}
  • {{LOCALTIMESTAMP}}

如果需要更詳盡的時間格式,或是在輸出目前年份和星期時更好的遵守ISO-8601,您可以使用#time}}解析器函數。

技術元數據

變量 輸出 描述 備註
站點
{{SITENAME}} 求聞百科 網站的名稱($wgSitename)。
{{SERVER}} https://www.qiuwenbaike.cn 域名URL$wgServer).
{{SERVERNAME}} www.qiuwenbaike.cn 子域名和域名(自版本1.17後不再取決於$wgServerName)。
{{DIRMARK}}

{{DIRECTIONMARK}}


輸出這個wiki默認語言所使用的Unicode文本方向控制字符(從左到右書寫的語言使用‎,反之使用‏),這在多方向文本中很有用。它取決於頁面語言。
{{SCRIPTPATH}} 腳本相對路徑($wgScriptPath)。
{{STYLEPATH}} /skins 樣式相對路徑($wgStylePath)。
{{CURRENTVERSION}} 1.41.1 (069bec4) 此站點的MediaWiki版本。
{{CONTENTLANGUAGE}}

{{CONTENTLANG}}

zh

zh

默認界面語言($wgLanguageCode)。
頁面
{{PAGEID}} 2234347 返回頁面編號。
{{PAGELANGUAGE}}
{{#language:{{PAGELANGUAGE}}}}
zh
中文
返回當前頁面的語言。此變量返回的語言代碼可使用{{#language:...}}轉換為語言名。
{{PROTECTIONLEVEL:操作}} 輸出當前頁面對於特定行為(比如edit,move)的保護級別(autoconfirm或sysop等)。若未保護則返回空字符串。
{{PROTECTIONEXPIRY:动作}} 根據給出的動作(如edit、move),返回當前頁面的保護信息(例如:時間戳「20160418155030」,或「infinity」) 如果未被保護,則會返回"infinity"。
{{CASCADINGSOURCES}} [高開銷] 返回當前頁面上的任意連鎖保護操作來源。除非存在自我嵌入,否則頁面將不會返回其各自標題。
最近一次編輯版本號
{{REVISIONID}} - 唯一的版本ID。 在預覽中為空,因此能用來顯示僅限於預覽時的錯誤訊息。可能在吝嗇模式($wgMiserMode)中被停用。
{{REVISIONDAY}} 23 最近一次編輯的日期(無前導0)。
{{REVISIONDAY2}} 23 最近一次編輯的日期(前導0)
{{REVISIONMONTH}} 02 最近一次編輯的月份(有前導0)。
{{REVISIONMONTH1}} 2 最近一次編輯的月份(沒有前導0)。
{{REVISIONYEAR}} 2024 最近一次編輯的年份
{{REVISIONTIMESTAMP}} 20240223210605 最近一次編輯的時間戳。
{{REVISIONUSER}} 待春 最近一個對指定頁面作出編輯的用戶,或者當前正在對其編輯進行預覽的用戶。
{{REVISIONSIZE}} 61449 當前版本頁面的大小(wikitext)。
影響頁面內容
{{DISPLAYTITLE:标题}}
{{DISPLAYTITLE:标题|noerror}}
{{DISPLAYTITLE:标题|noreplace}}
設置當前頁面標題的顯示格式。變量值須與標題等值:只允許對標題的特定部分(不是全部標題)的大小寫變化和用下劃線替換替換空格(這個設定可以通過$wgRestrictDisplayTitle改變)。可以通過$wgAllowDisplayTitle將其啟用或禁用;在1.10+前默認禁用,之後的版本中默認啟用。

可以使用第二個參數:「noerror」關閉使用多個本魔術字時導致錯誤消息提示。或「noreplace」如果displaytitle在前文已經設置,則關閉使用多個本魔術字時導致錯誤消息提示令displaytitle失效。


(以無錯誤提示、不替換為目的)

{{DEFAULTSORT:排序关键字}}
{{DEFAULTSORTKEY:排序关键字}}
{{DEFAULTCATEGORYSORT:排序关键字}}
{{DEFAULTSORT:排序关键字|noerror}}
{{DEFAULTSORT:排序关键字|noreplace}}
在分類頁面上使用,用來設置默認在分類中排序關鍵字。 例如當你將{{DEFAULTSORT:Smith, John}}放到頁面John Smith的結尾,該頁面在分類頁面上的列表中將默認排到「S」項下。 可以使用第二個參數:「noerror」關閉使用多個本魔術字時導致錯誤消息提示。或「noreplace」如果defaultsort在前文已經設置,則關閉使用多個本魔術字時導致錯誤消息提示,令defaultsort失效。


(以無錯誤提示、不替換為目的)

統計

這些變量返回的數字往往包含分隔符(根據本地語言參數設置而可能是逗號或空格)。可以通過「:R」來返回無分隔號的數字(例如{{NUMBEROFPAGES}} → 2,674,910和{{NUMBEROFPAGES:R}} → 2674910)。

對於PAGESINCATEGORY等需要參數的變量則使用「|R」(例如{{PAGESINCategory:求闻百科分类}}{{PAGESINCategory:求闻百科分类|R}}{{PAGESINCategory:求闻百科分类|subcats}}{{PAGESINCategory:求闻百科分类|subcats|R}})。 也適用於上述{{PAGESIZE:页面名称}}

返回數字的魔術字數字格式取決於內容語言的設定,取決於頁面內容語言。

變量 輸出 描述
{{NUMBEROFPAGES}} 2,674,910 頁面數量
{{NUMBEROFARTICLES}} 1,145,675 在內容名字空間中,作為條目的頁面個數。
{{NUMBEROFFILES}} 96,379 上傳文件的個數。
{{NUMBEROFEDITS}} 7,263,653 編輯的數量
{{NUMBEROFVIEWS}} 頁面瀏覽次數。通常對使用緩存的wiki無效。
{{NUMBEROFUSERS}} 1,562 註冊用戶數量
{{NUMBEROFADMINS}} 31 管理員(sysop)組的用戶數。
{{NUMBEROFACTIVEUSERS}} 74 活躍用戶總數,其標準與Special:Statistics中的標準相同。
{{PAGESINCATEGORY:分类名称}}
{{PAGESINCAT:分类名称}}
10
0
[高開銷] 指定分類中的頁面總數(包括子類和文件)。Category:求聞百科分類 在此用於演示)
{{PAGESINCATEGORY:分类名称|all}}
{{PAGESINCATEGORY:分类名称|pages}}
{{PAGESINCATEGORY:分类名称|subcats}}
{{PAGESINCATEGORY:分类名称|files}}
10
0
10
0
[高開銷] 返回指定分類的:
  • 所有頁面數
  • 所有非分類頁和非文件頁數
  • 所有子分類頁數
  • 所有文件頁數

Category:求聞百科分類 在此用於演示)

{{NUMBERINGROUP:用户组}}
{{NUMINGROUP:用户组}}
31
31
特定用戶組中的用戶總數 (sysop用於演示)
{{PAGESINNS:索引编号}}
{{PAGESINNAMESPACE:索引编号}}
未啟用 [高開銷] 指定名字空間中的頁面總數。(將「索引編號」替換成相關名字空間編號)。 例如{{PAGESINNAMESPACE:14}}返回分類頁面總數。{{PAGESINNS:0}}{{NUMBEROFARTICLES}}不同之處在於包括重定向頁面和消除歧義頁面。 默認禁用,可以通過$wgAllowSlowParserFunctions設置啟用。

頁面名稱

變量 對於當前頁面 描述
{{FULLPAGENAME}} Help:魔術字 命名空間與完整頁面標題(包括子頁面級別)。
{{PAGENAME}} 魔術字 不包含名字空間的完整頁面標題(包括子頁面級別)。
{{BASEPAGENAME}} 魔術字 頁面標題,不包括當前子頁面標題及命名空間。 在Help:Title/Foo/Bar頁面返回Title/Foo
{{ROOTPAGENAME}} 魔術字 獲得當前頁面的根頁名。 在Help:Title/Foo/Bar頁面返回Title
{{SUBPAGENAME}} 魔術字 子頁面標題。 在Help:Title/Foo/Bar頁面返回Bar

如果子頁面不存在將會回傳{{PAGENAME}}的值。

如果需要使用更多匹配的話,請使用解析器函數擴充功能{{#titleparts:}}

{{SUBJECTPAGENAME}}
{{ARTICLEPAGENAME}}
Help:魔術字
Help:魔術字
獲得該頁面的完整頁面名。對討論頁十分有用。
{{TALKPAGENAME}} Help talk:魔術字 關聯討論頁的完整頁面名稱

這些變量不受 {{DISPLAYTITLE:xxxx}} 影響,它們都會按原來的頁面標題計算返回值。

{{BASEPAGENAME}}{{SUBPAGENAME}}這兩個魔術字只在啟用了子頁面模式的名字空間才生效。關於啟用子頁面模式請看$wgNamespacesWithSubpages

以上魔術字可以接受一個參數,用於指定特定頁面,來代替要處理的當前頁面設定:

  • {{PAGENAME:Template:Main Page}} → Main Page

URL 編碼後的頁面名稱

以下是在MediaWiki URL中的等價編碼(就是空格替換為下劃線,以及使用數字字符編碼的一HTML溢出字符):

  • {{FULLPAGENAMEE}}
  • {{PAGENAMEE}}
  • {{BASEPAGENAMEE}}
  • {{SUBPAGENAMEE}}
  • {{SUBJECTPAGENAMEE}}
  • {{ARTICLEPAGENAMEE}}
  • {{TALKPAGENAMEE}}
  • {{ROOTPAGENAMEE}}

注意{{PAGENAME:...}}{{PAGENAMEE:...}}{{urlencode:...}}有不同的實現方式。

命名空間

變量 輸出 描述 版本
{{NAMESPACE}} Help 頁面的命名空間的名稱 (除去主空間)
{{NAMESPACENUMBER}} 12 頁面所在名字空間的ID
{{SUBJECTSPACE}}
{{ARTICLESPACE}}
Help
Help
相關聯的內容名字空間的名稱
{{TALKSPACE}} Help talk 相關聯的討論名字空間的名稱

以下是在MediaWiki URL中的等價編碼(空格替換為下劃線,一些字符替換為百分號編碼):

  • {{NAMESPACEE}}
  • {{SUBJECTSPACEE}}
  • {{ARTICLESPACEE}}
  • {{TALKSPACEE}}

這些可以是完整頁面名參數,並將返回與那個頁面相關的請求名字空間,而不是在當前頁面中:

  • {{NAMESPACENUMBER:MediaWiki}}0
  • {{NAMESPACE:MediaWiki}} (Pages in main space will return empty)
  • {{NAMESPACE:Template:Main Page}}Template
  • {{SUBJECTSPACE:Template:Main Page}}Template
  • {{ARTICLESPACE:Template:Main Page}}Template
  • {{TALKSPACE:Template:Main Page}}Template talk

參數必須不是一個名字空間名稱:

  • {{SUBJECTSPACE:Help talk}}  (Empty)

其他

變量 輸出 描述
{{!}} | 用於在模板或者是表格內插入管道符號。在被添加為魔術字之前,許多wiki通過創建Template:!(內容為|)來實現。

有關更多說明,請參見幫助:擴展:解析器函數#在表格中逸出的管道符

{{=}} = 用於在模板參數或表格的單元格內容中插入等於號。 在被添加為魔術字之前,許多wiki通過創建Template:=(內容為=)來實現。

有關更多說明,請參見幫助:擴展:解析器函數#原始等號

解析器函數

解析器函數與變量相似,但需要一個或多個參數(技術上講,任何需要參數的魔術字都是解析器函數),並且名稱有時以井號(hash)開頭,以與模板區分開來。

此頁面只描述MediaWiki軟件中重要的解析器函數。其他MediaWiki軟件可能添加的解析器函數包括ParserFunctions等。

另一頁面的技術元數據

解析器函數 輸出 描述
{{PAGEID: 页面名称 }} 1 [高開銷] 返回指定頁面*的頁面標識符。
{{PAGESIZE:页面名称}}
{{PAGESIZE: 页面名称 |R}}
28
28
[高開銷] 返回特定頁面的字節大小。使用「|R」獲取原始(未處理)數值。
{{PROTECTIONLEVEL:操作 | 页面名称}} templateeditor [高開銷] 輸出當前頁面對於特定行為(比如edit,move)的保護級別(autoconfirm或sysop等)。若未保護則返回空字符串。
{{PROTECTIONEXPIRY: 操作 | 页面名称}} infinity [高開銷] 根據給出的動作(如edit、move),返回當前頁面的保護信息(例如:時間戳「20160418155030」,或「infinity(無限期)」) 如果未被保護,則會返回"infinity(無限期)"。
{{CASCADINGSOURCES: page name}} [高開銷] 返回在特定頁面上任意連鎖保護的來源。頁面將不會返回其本身標題,除非頁面有自我嵌入行為。
{{REVISIONID: 页面名称 }} 7269007 [高開銷] 當前頁面的最新更改的ID。
{{REVISIONDAY: 页面名称 }} 15 [高開銷] 指定頁面的最新更改的天* (未補全的數字)。
{{REVISIONDAY2: 页面名称 }} 15 [高開銷] 指定頁面的最新更改的天* (以0補全的數字)。
{{REVISIONMONTH: 页面名称 }} 04 [高開銷] 指定頁面的最新修改的月* (以0補全的數字)。
{{REVISIONMONTH1: 页面名称 }} 4 [高開銷] 指定頁面的最新修改的月* (未補全的數字)。
{{REVISIONYEAR: 页面名称 }} 2024 [高開銷] 指定頁面的最新修改的年*。
{{REVISIONTIMESTAMP: 页面名称 }} 20240415081127 [高開銷] 指定頁面的最新修改的時間截*。
{{REVISIONUSER: 页面名称 }} 待春 [高開銷] 指定頁面的最新修改的用戶名*。
*當提供的參數等於當前解析器標題,在預覽時以及在替換使用時解析器函數將產生上一版本,在用於頁面創建時,這包括空字符串,但使用來自當前版本頁面瀏覽的值,包括瀏覽舊版本。這種情況下它並非高開銷函數解析器。

URL數據

解析器函數 輸入 → 輸出 描述
{{localurl:页面名称}}
{{localurl:页面名称
|请求参数}}
{{localurl:MediaWiki}}
→ /wiki/MediaWiki
{{localurl:MediaWiki|printable=yes}}
→ /index.php?title=MediaWiki&printable=yes
至標題的相對路徑。
{{fullurl:页面名称}}
{{fullurl:页面名称
|请求参数}}

{{fullurl:跨站前缀:另一站点上的页面名称
|请求参数}}
{{fullurl:Category:Top level}}
https://www.qiuwenbaike.cn/wiki/Category:Top_level

{{fullurl:Category:Top level|action=edit}}
https://www.qiuwenbaike.cn/index.php?title=Category:Top_level&action=edit
{{fullurl:s:Electra|action=edit}}
https://www.qiuwenbaike.cn/index.php?title=S:Electra&action=edit
{{fullurl:s:es:Electra|action=edit}}
https://www.qiuwenbaike.cn/index.php?title=S:es:Electra&action=edit

至標題的協議相對路徑,基於本地wiki的$wgServer設定(且不一定會以http(s)://開頭)。這也將解決跨wiki前綴。注意:未加括號的(單一)協議相對鏈接不會自動鏈接。
{{canonicalurl:页面名称}}
{{canonicalurl:页面名称
|请求参数}}

{{canonicalurl:跨站前缀:另一站点上的页面名称
|请求参数}}
{{canonicalurl:Category:Top level}}
https://www.qiuwenbaike.cn/wiki/Category:Top_level

{{canonicalurl:Category:Top level|action=edit}}
https://www.qiuwenbaike.cn/index.php?title=Category:Top_level&action=edit {{canonicalurl:w:Category:Top level|action=edit}}
https://www.qiuwenbaike.cn/index.php?title=W:Category:Top_level&action=edit

至標題的絕對路徑,使用規範URL。這也將解決跨wiki前綴。
{{filepath:文件名称}}
{{filepath:文件名称|nowiki}}
{{filepath:文件名称|缩略图大小}}
{{filepath:Qiuwen.svg}}
https://tu.zhongwen.wiki/images/qiuwenbaike/zh/3/34/Qiuwen.svg

{{filepath:Qiuwen.svg|nowiki}}
→ https://tu.zhongwen.wiki/images/qiuwenbaike/zh/3/34/Qiuwen.svg
{{filepath:Qiuwen.svg|300}}
https://tu.zhongwen.wiki/images/qiuwenbaike/zh/thumb/3/34/Qiuwen.svg/300px-Qiuwen.svg.png

參數nowiki通常會刪除文件路徑周圍的鏈接(在本例中看不到)。

媒體文件的完整大小或縮略圖的協議相對路徑。
{{urlencode:字符串}}
{{urlencode:字符串|QUERY}}
{{urlencode:字符串|WIKI}}
{{urlencode:字符串|PATH}}
{{urlencode:x:y/z á é}}
{{urlencode:x:y/z á é|QUERY}}
→ x%3Ay%2Fz+%C3%A1+%C3%A9
{{urlencode:x:y/z á é|WIKI}}
→ x:y/z_%C3%A1_%C3%A9
{{urlencode:x:y/z á é|PATH}}
→ x%3Ay%2Fz%20%C3%A1%20%C3%A9

請注意,在1.17中,默認值從|WIKI更改為|QUERY,這可能會破壞依賴此功能的模板。

編碼的輸入用於URL。請注意,沒有像過時的StringFunctions中那樣的urldecode函數
字符編碼
代碼空格
 none + 
QUERY + 
 WIKI _ 
 PATH%20
{{anchorencode:字符串}} {{anchorencode:x y z á é}}
→ x_y_z_á_é
編碼的輸入用於URL部分錨點(在URL中的「#」符號之後)。

命名空間

{{ns:}}使用該索引,規範名稱或本地別名返回名字空間的當前本地化名稱。因此{{ns:6}}{{ns:file}}{{ns:image}}(File名稱空間的舊名稱)都返回File。

{{nse:}}是MediaWiki URL的等效編碼。它也是這樣,但它用下劃線替換空格,使其可用於外部連結。

內容名字空間 討論名字空間
用法 輸出 用法 輸出
{{ns:-2}} / {{ns:Media}} Media {{ns:-1}} / {{ns:Special}} Special
(no talk page)
{{ns:0}} / {{ns:}} {{ns:1}} / {{ns:Talk}} Talk
{{ns:2}} / {{ns:User}} User {{ns:3}} / {{ns:User talk}} User talk
{{ns:4}} / {{ns:Project}} Qiuwen
Varies between wikis
{{ns:5}} / {{ns:Project talk}} Qiuwen talk
{{ns:6}} / {{ns:File}} or {{ns:Image}} File {{ns:7}} / {{ns:File talk}} or {{ns:Image talk}} File talk
{{ns:8}} / {{ns:MediaWiki}} MediaWiki {{ns:9}} / {{ns:MediaWiki talk}} MediaWiki talk
{{ns:10}} / {{ns:Template}} Template {{ns:11}} / {{ns:Template talk}} Template talk
{{ns:12}} / {{ns:Help}} Help {{ns:13}} / {{ns:Help talk}} Help talk
{{ns:14}} / {{ns:Category}} Category {{ns:15}} / {{ns:Category talk}} Category talk

不要將本地化名字空間與自定義名字空間相混淆。

格式化

用法 輸入 → 輸出 描述

{{formatnum:未格式化数字}}
{{formatnum:formatnum格式化过的数字|R}}
{{formatnum:未格式化数字|NOSEP}}

  • 簡單:
    • {{formatnum:987654321.654321}}
      → 987,654,321.654321
    • {{formatnum:987,654,321.654321|R}}
      → 987654321.654321
  • 高級:
    • {{formatnum:{{formatnum:987654321.654321}}|R}}
      → 987654321.654321 (於任意語言)
    • {{formatnum:00001}}
      → 00,001
    • {{formatnum:987654321.654321 |NOSEP}}
      → 987654321.654321
    • 孟加拉字母的例子:
      • {{formatnum:987654321.654321}}
        → ৯৮,৭৬,৫৪,৩২১.৬৫৪৩২১
      • {{formatnum:987654321.654321 |NOSEP}}
        → ৯৮৭৬৫৪৩২১.৬৫৪৩২১
      • {{formatnum:৯৮,৭৬,৫৪,৩২১.৬৫৪৩২১ |R}}
        → 987654321.654321

不被支持的:
{{formatnum:{{formatnum:987.654.321}}}}
→ 987 654 321 (例如與意大利語區域設置)


錯誤輸入(不可靠輸出)的示例,有或沒有|R
{{formatnum:987,654.321|R}} (這個應該會壞)
{{formatnum:987.654,321|R}}
{{formatnum:987 654,321|R}}
{{formatnum:987 654,321|R}}

採用未格式化的數字(例如阿拉伯語數字,沒有組分隔符和.作為小數分隔符)並將其輸出到本地化的數字腳本中,並使用十進制和十進制組分隔符進行格式化,到wiki的默認語言環境。

|R參數可以用於反轉此行為,用於數學運算:這種方法可靠,但只應該用於反向轉換與wiki的語言環境相同(原先formatnum會轉換到的)的數字。
指定 NOSEP(「無分隔符」)參數會使數位分組分隔符和小數點分隔符不被修改,此時 formatnum 只會在不使用印度-阿拉伯數字系統的語言中將數字字符進行轉換。NOSEP 參數還會防止出現意外的非標準數字分組。




如果你真的需要輸入一個無法保證格式正確的數字(根據Wiki的語言環境)的話,你可以使用formatnum兩次(但請不要在輸入數字可能有數位分組格式的情況下使用這種變通方式,否則分隔符可能會消失或數字無法被格式化)。請注意這種方法是非常取巧的,因此它的輸出結果可能不可靠。

{{#dateformat:date}}
{{#formatdate:date}}
{{#dateformat:date|format}}
{{#formatdate:date|format}}

{{#dateformat:25 dec 2009|ymd}}
→ 25 dec 2009 (您的首選)2009年12月25日(默認)
{{#formatdate:dec 25,2009|dmy}}
→ dec 25,2009 (您的首選)25日12月2009年(默認)
{{#dateformat:2009-12-25|mdy}}
12月 25, 2009 (您的首選)12月25日,2009年(默認)
{{#formatdate:2009 dec 25|ISO 8601}}
→ 2009 dec 25 (您的首選)2009-12-25(默認)
{{#dateformat:25 decEmber|mdy}}
→ 25 decEmber (您的首選)12月25日(默認)
注意:在上述例子中,「您的首選」僅指當前Wiki(也就是 MediaWiki.org)上的日期首選項。

根據用戶的「日期格式」設置格式化給定日期,並添加將其標記為格式化日期的元數據。對於未登錄的遊客和沒有在設置中指定日期格式的用戶,日期可以按以下默認格式給定:mdydmyymdISO 8601(大小寫敏感)。如果只給定了月份和日期的話,只有 mdydmy 是合法格式。如果未給定日期格式或日期格式不合法,則輸入格式將用作為默認格式。如果提供的日期未被識別為有效日期(特別是,如果它包含任何元數據,例如來自另一個 dateformat或類似模板的嵌套使用),則將其保持不變,並且不會生成額外的元數據。

{{lc:string}}

{{lc:DATA CENTER}} → data center 小寫輸入。

{{lcfirst:string}}

{{lcfirst:DATA center}} → dATA center 輸入的內容會強制將首字母小寫化。

{{uc:string}}

{{uc:text transform}} → TEXT TRANSFORM 大寫輸入。

{{ucfirst:string}}

{{ucfirst:text tRAnSFORM}} → Text tRAnSFORM 輸入的內容會強制將首字母大寫化。

{{padleft:xyz|stringlength}}
{{padleft:xyz|strlen|char}}
{{padleft:xyz|strlen|string}}

{{padleft:xyz|5}} → 00xyz

{{padleft:xyz|5|_}} → __xyz
{{padleft:xyz|5|abc}} → abxyz
{{padleft:xyz|2}} → xyz
{{padleft:|1|xyz}} → x (字符串的首字母)

將參數1通過在左側補上參數3指定的字符串(默認為0)補足到參數2指定的長度。 例如 {{padleft:44|3|0}} 生成 044。 參數3指定的字符串可能被截斷以保證補足後的字符串長度滿足要求。

在 1.12 版本以前,第三個參數只使用傳入的字符串的第一個字符,但從 1.15 版本以後,第三個參數傳入的字符串的所有字符都會被使用。

{{padright:xyz|stringlength}}
{{padright:xyz|strlen|char}}
{{padright:xyz|strlen|string}}

{{padright:xyz|5}} → xyz00

{{padright:xyz|5|_}} → xyz__
{{padright:xyz|5|abc}} → xyzab
{{padright:xyz|2}} → xyz
{{padright:|1|xyz}} → x

除了在右側補上字符串外,其他與 padleft 一致。

本地化

這些是用於本地化工具的魔術字。其他的魔術字經常依賴wiki的本地化和位置,或者其他已選的語言,參見特定的#日期和時間#格式化雜項

魔術字的用法會非常複雜,而且文檔目前還不完整。

用法 輸入 → 輸出 描述
{{plural:2|is|are}} {{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
{{plural:1|is|are}} → is
{{plural:2|is|are}} → are
{{plural:-1|is|are}} → is
{{plural:-2|is|are}} → are
{{plural:0.5|is|are}} → are
{{plural:1.5|is|are}} → are
{{plural:-0.5|is|are}} → are
{{plural:-1.5|is|are}} → are
(用於俄語
{{PLURAL:5|1=Категория|Категории}}  → Категории


{{PLURAL:3|страница|страницы|страниц}} → страницы
{{PLURAL:5|страница|страницы|страниц}} → страниц

根據參數1是單數還是複數,輸出不同的字符串:單數輸出參數2,複數輸出參數3。它的表現是與界面語言相關的。
一些語言(ab、av、ba、bxr、ce、crh_cyrl、cv、inh、koi、krc、kv、lbe、lez、mhr、mrj、myv、ru、tt_cyrl、tyv、udm、xal)使用3種複數形式
  • 表格1: 1, 21, 31, 41, 51, 61, 71, 81, 101, 1001, …
  • 表格2: 0, 5, 6, 7, 8, …, 18, 19, 100, 1000, 10000, 100000, 1000000, …
  • 表格3: 2, 3, 4, 22, 23, 24, 32, 33, 34, 42, 43, 44, 52, 53, 54, 62, 102, 1002, …
{{grammar:N|noun}} 根據分號後的詞形變化代碼輸出給定的詞的正確的詞形變化。語法變形被用于波蘭語這樣的屈折語。參見 $wgGrammarForms
{{gender:username|text for every gender}}

{{gender:Username|male text|female text|text for unspecified}}
{{gender:|male text|female text|text for unspecified}}
{{gender:.|male text|female text|text for unspecified}}

(取決於指定用戶的性別) 根據指定的用戶的設置返回該性別對應的文本。

注意: 第一個例子基本上啥也沒幹
注意: 如果參數3未給出,且用戶未設置TA的性別時將返回 text if user is male
空的用戶名({{gender:|)指代當前用戶,但這種方式只能在MediaWiki命名空間下的頁面使用。
用戶名為點 (.) 時使用站點默認設置。

{{int:消息名称}} {{int:edit}}編輯
(取決於用戶語言,可以試試:frja
該解析器函數將會把(MediaWiki命名空間下的)界面消息翻譯成用戶語言。msgnw和其他嵌套引用魔術字參見嵌入修改器一節。注意在1.17版本以前,這麼做會導致緩存一致性被破壞
{{int:editsectionhint|MediaWiki}} {{int:editsectionhint|MediaWiki}}編輯章節:MediaWiki 你可以在翻譯過程中使用參數。
界面消息里的參數使用 $1、$2、$3 來引用
例如,editsectionhint界面消息的源碼為:編輯章節:$1
在左側例子中,MediaWiki 替換了 $1。

嵌入修改器

{{页面名|可选参数}} 默認從 Template: 命名空間嵌入頁面。 這些魔術字會修改此行為。

雜項

有關解析器函數#invoke,見Lua幫助文檔

參見