說明:魔術字

MediaWiki中的相關條目：

Help:Magic words

這是一個用於MediaWiki的魔術字索引。

魔術字是MediaWiki軟體所辨識的特定字串，它們可以返回特定的值或觸發其他的功能。

大致資訊

魔術字有如下三種：

• 狀態開關：以兩個底線「__」為前字尾的大寫單詞。例如__FOO__；
• 變數：同模板類似，以「{{」開頭「}}」結尾，且所有字母大寫，如{{FOO}}；
• 解析器函式：這些形如{{foo:...}}或{{#foo:...}}的魔術字在使用時包含參數，且函式名稱對大小寫不敏感（包括可大小寫混用）。請同時參見Help:解析器函式。

狀態開關

狀態開關可以控制頁面的顯示方式或其他行為。它往往用於排除或加入特定的頁面內容。

魔術字	描述	版本
目錄
__NOTOC__	隱藏目錄。
__FORCETOC__	強制於預設位置（第一個章節標題上方）顯示目錄。
__TOC__	在魔術字的位置插入目錄（忽略__NOTOC__）。如果這個魔術字在一個頁面內被多次使用，目錄將會被放置在首個__TOC__出現的位置。
編輯
__NOEDITSECTION__	隱藏章節標題旁的編輯連結。
__NEWSECTIONLINK__	在非討論頁頂端「編輯頁面」標籤右側加入一個按鈕，用於在頁面結尾加入新的章節（參見MediaWiki上的說明）。	1.7+
__NONEWSECTIONLINK__	移除討論頁頂端「編輯頁面」右側的加入新章節連結。	1.15+
分類
__NOGALLERY__	用於分類頁面。不顯示分類中所包含檔案的縮圖，而以普通連結代替。	1.7+
__HIDDENCAT__	用於分類頁面。加入後此分類成為隱藏分類，將不會顯示在上級分類其及成員頁面的分類列表中（可以通過偏好設定中的選項強制顯示），建議用{{hiddencat}}。	1.13+
字詞轉換
__NOCONTENTCONVERT__ __NOCC__	不對當前頁面進行字詞轉換。
__NOTITLECONVERT__ __NOTC__	不進行標題轉換，其他內容照常轉換。
其他
__START__	沒有特殊效果。用於標識提交後不需要轉換的資料庫資訊。功能已經移除。	r1695時功能移除，r24784時完全移除
__INDEX__	允許搜尋引擎檢索本頁（忽略$wgArticleRobotPolicies的偏好設定，但無法忽略robots.txt）。	1.14+
__NOINDEX__	阻止搜尋引擎檢索本頁。	1.14+
__STATICREDIRECT__	用於重新導向頁面。當有人移動頁面並勾選「更新所有指向原標題的重定向」時，禁止MediaWiki更新本頁的重定向。	1.13+
__DISAMBIG__	用於消歧義頁，該頁會被標記為消歧義頁並顯示於Special:消歧義頁面，建議用{{Disambig}}。	使用消歧義外掛程式

變數

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

如果某一模板名與變數名重複，軟體會自動將其解釋為變數（因此若要包含Template:PAGENAME，頁面中需要寫作{{Template:PAGENAME}}）。在某些情況下，加入參數會強制軟體將變數視作一個模板，如{{CURRENTDAYNAME|x}}將會包含Template:CURRENTDAYNAME。

日期與時間

以下變數返回用戶所偏好設定的時區日期或時間，預設為UTC時間。

在MediaWiki與瀏覽器快取的影響下，這些變數顯示的往往是被快取的值，而非當前的時間。

變數	輸出	描述	版本
年
{{CURRENTYEAR}}	2024	年
月
{{CURRENTMONTH}}	12	月（補足前導零）
{{CURRENTMONTHNAME}}	12月	月（本地語言中的月份名稱）
{{CURRENTMONTHNAMEGEN}}	12月	月（本地語言中月份名稱的屬格形式）
{{CURRENTMONTHABBREV}}	12月	月（本地語言中月份名稱的簡稱）	1.5+
日
{{CURRENTDAY}}	22	日（無前導零）
{{CURRENTDAY2}}	22	日（補足前導零）	1.6+
星期
{{CURRENTDOW}}	0	星期（數字格式）
{{CURRENTDAYNAME}}	星期日	星期
時間
{{CURRENTTIME}}	07:59	時間（24小時制，格式為HH:mm）
{{CURRENTHOUR}}	07	時間（24小時制，有前導零）
其他
{{CURRENTWEEK}}	51	周數
{{CURRENTTIMESTAMP}}	20241222075917	YYYYMMDDHHmmss時間戳	1.7+

如下變數和以上列出的變數功能相同，但是使用的是站點所在時區的本地時間，而非用戶所偏好設定的時區或UTC：

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

對於更詳細的時間格式，請參見Help:時間序號。

技術元資料

歷史版本變數返回的是與當前頁面最近一次編輯有關的資料。

變數	輸出	描述	版本
站點
{{SITENAME}}	Wikibooks	站點名稱（$wgSitename）
{{SERVER}}	//zh.wikibooks.org	域名URL（$wgServer）
{{SERVERNAME}}	zh.wikibooks.org	域名名稱（$wgServerName）
{{DIRMARK}} {{DIRECTIONMARK}}	‎ ‎	輸出這個wiki預設語言所使用的Unicode文字方向控制字元（從左到右書寫的語言使用‎，反之使用‏）	1.7+
{{SCRIPTPATH}}	/w	相對指令碼路徑（$wgScriptPath）
{{CURRENTVERSION}}	1.44.0-wmf.8 （f08e6b3）	當前所使用的MediaWiki版本	1.7+
{{CONTENTLANGUAGE}} {{CONTENTLANG}}	zh zh	預設的介面語言（$wgLanguageCode）	1.7+
當前頁面的最新編輯版本
{{REVISIONID}} {{REVISIONID:頁面標題}}	-	最近一次編輯版本的ID [高開銷]指定頁面最近修訂版本的ID	1.5+ 1.16+
{{REVISIONDAY}} {{REVISIONDAY:頁面標題}}	11	最近一次編輯的日份 [高開銷]指定頁面最近一次編輯的日份	1.8+ 1.16+
{{REVISIONDAY2}} {{REVISIONDAY2:頁面標題}}	11	最近一次編輯的日份（前導零） [高開銷] 指定頁面最近一次編輯的日份	1.8+ 1.16+
{{REVISIONMONTH}} {{REVISIONMONTH:頁面標題}}	02	最近一次編輯的月份 [高開銷] 指定頁面最近一次編輯的月份	1.8+ 1.16+
{{REVISIONYEAR}} {{REVISIONYEAR:頁面標題}}	2018	最近一次編輯的年份 [高開銷]指定頁面最近一次編輯的年份	1.8+ 1.16+
{{REVISIONTIMESTAMP}} {{REVISIONTIMESTAMP:頁面標題}}	20180211045849	最近一次編輯的時間戳 [高開銷]最近修訂版本的時間戳	1.8+ 1.16+
{{REVISIONUSER}} {{REVISIONUSER:頁面標題}}	Fanjiayi	最近一個對本頁面作出編輯的用戶 [高開銷] 最近一個對指定頁面作出編輯的用戶 在編輯提示里顯示即將編輯的用戶，見[1]	1.15+ 1.16+
{{PAGESIZE:頁面標題}} {{PAGESIZE:Help:魔術字}}	0	[高開銷]返回指定頁面的大小	1.13+
{{PROTECTIONLEVEL:行為}}	保護級別	輸出當前頁面對於特定行為（create，edit或move）的保護級別（autoconfirm或sysop等）。若未保護則返回空字串。	1.15+
影響頁面內容
{{DISPLAYTITLE:標題}}		更改頁面的標題，與-{T|}-類似，不推薦使用。可以通過$wgAllowDisplayTitle將其啟用或禁用。在1.10+前預設禁用，之後的版本中預設啟用。	1.7+
{{DEFAULTSORT:排序索引}} {{DEFAULTSORTKEY:排序索引}} {{DEFAULTCATEGORYSORT:排序索引}}		為頁面偏好設定一個預設的排序索引。例如在吉米·威爾士條目的結尾加入{{DEFAULTSORT:Wales, Jimmy}}，則預設此條目在所有分類中都會排在「W」下，而非「吉」。	1.10+

統計

這些變數返回的數字往往包含分隔符（根據本地語言偏好設定而可能是逗號或空格）。可以通過「:R」來返回無分隔號的數字（例如{{NUMBEROFPAGES}}→19,240而{{NUMBEROFPAGES:R}}→19240)）。對於PAGESINCATEGORY等需要參數的變數則使用「|R」（例如{{PAGESINCATEGORY:Help}}及{{PAGESINCATEGORY:Help|R}}）。

變數	輸出	描述	版本
整個站點
{{NUMBEROFPAGES}}	19,240	頁面總數	1.7+
{{NUMBEROFARTICLES}}	3,725	主命名空間內的頁面總數
{{NUMBEROFFILES}}	102	上傳的檔案總數	1.5+
{{NUMBEROFEDITS}}	178,991	總頁面編輯次數	1.10+
{{NUMBEROFVIEWS}}		頁面瀏覽次數。通常對使用快取的wiki無效。	1.14～1.24
{{NUMBEROFUSERS}}	66,291	註冊用戶總數	1.7+
{{NUMBEROFADMINS}}	8	sysop用戶組中的用戶總數	1.7+
{{NUMBEROFACTIVEUSERS}}	30	活躍用戶總數，其標準與Special:Statistics中的標準相同	1.15+
{{PAGESINCATEGORY:分類標題}} {{PAGESINCAT:帮助文档}}	4	[高開銷]指定分類中的頁面總數。	1.13+
{{PAGESINCATEGORY:帮助文档|all}} {{PAGESINCATEGORY:帮助文档|pages}} {{PAGESINCATEGORY:帮助文档|subcats}} {{PAGESINCATEGORY:帮助文档|files}}	4 4 0 0	[高開銷]返回指定分類的： 所有頁面數 所有非分類頁和非檔案頁數 所有子分類頁數 所有檔案頁數	1.20+
{{NUMBERINGROUP:用戶群組}} {{NUMINGROUP:用戶群組}}	{{NUMBERINGROUP:bureaucrat}}→ 0	特定用戶群組中的用戶總數	1.14+
{{PAGESINNS:索引編號}} {{PAGESINNAMESPACE:索引編號}}	禁用	指定命名空間中的頁面總數。例如{{PAGESINNAMESPACE:14}}返回分類總數。在中文維基百科被禁用。	1.7+

頁面標題

變數	輸出	描述	版本
{{FULLPAGENAME}}	Help:魔術字	命名空間及頁面標題	1.6+
{{PAGENAME}}	魔術字	頁面標題
{{BASEPAGENAME}}	魔術字	頁面標題，不包括當前子頁面標題及命名空間（頁面「Wikipedia:頁面/子頁面」則返回「頁面」）	1.7+
{{SUBPAGENAME}}	魔術字	子頁面標題（頁面「Wikipedia:頁面/子頁面」則返回「子頁面」）	1.6+
{{SUBJECTPAGENAME}}	Help:魔術字	當前頁面對應的內容頁標題（包含命名空間）	1.7+
{{TALKPAGENAME}}	Help talk:魔術字	當前頁面對應的討論頁標題（包含命名空間）	1.7+

魔術字{{BASEPAGENAME}}和{{SUBPAGENAME}}僅在允許子頁面出現的命名空間中有效。參見mw:Manual:$wgNamespacesWithSubpages。

以下類似的魔術字返回URL編碼結果：

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

在1.15+版本中，這些魔術字均可通過參數來指明特定頁面：

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

命名空間

變數	輸出	描述	版本
{{NAMESPACE}}	Help	命名空間
{{SUBJECTSPACE}} {{ARTICLESPACE}}	Help Help	當前頁面對應的內容頁面命名空間	1.7+
{{TALKSPACE}}	Help talk	當前頁面對應的討論頁命名空間	1.7+

以下類似的魔術字返回URL編碼結果：

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

在1.15+版本中，這些魔術字均可通過參數來指明特定頁面：

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

其他

變數	輸出	描述	版本
{{!}}	|	在參數中代替|	1.24+

解析器函式

解析器函式與變數十分類似，但是有一個或多個參數（技術上來看，所有使用參數的魔術字均為解析器函式），且魔術字的名稱前往往會有一個#號，以將它們與一般的模版區分開來。

這一頁僅列出了整合在MediaWiki軟體中的解析器函式。其他擴充（例如ParserFunctions extension）可能為MediaWiki加入更多的解析器函式。請參見Help:解析器函式了解更多的解析器函式。

URL資料

魔術字	輸入 → 輸出	描述	版本
{{localurl:頁面標題}} {{localurl:頁面標題|字串}}	/wiki/%E9%A1%B5%E9%9D%A2%E6%A0%87%E9%A2%98 /w/index.php?title=%E9%A1%B5%E9%9D%A2%E6%A0%87%E9%A2%98&字串	指定標題的相對路徑
{{fullurl:頁面標題}} {{fullurl:頁面標題|字串}} {{fullurl:跨維基連結:頁面標題|字串}}	{{fullurl:Category:帮助文档}} → //zh.wikibooks.org/wiki/Category:%E5%B8%AE%E5%8A%A9%E6%96%87%E6%A1%A3 {{fullurl:Category:帮助文档|action=edit}} → //zh.wikibooks.org/w/index.php?title=Category:%E5%B8%AE%E5%8A%A9%E6%96%87%E6%A1%A3&action=edit {{fullurl:en:Category:Help|action=edit}} → https://en.wikibooks.org/wiki/Category:Help?action=edit	指定標題的絕對路徑，同時處理跨維基字首。	1.5+
{{filepath:檔名}} {{filepath:文件名|nowiki}}	{{filepath:Wiki.png}} → //upload.wikimedia.org/wikibooks/zh/b/bc/Wiki.png {{filepath:Wiki.png|nowiki}} → //upload.wikimedia.org/wikibooks/zh/b/bc/Wiki.png	指定多媒體檔案的絕對路徑	1.12+
{{urlencode:字串}}	{{urlencode:x y z 一二三}} → x+y+z+%E4%B8%80%E4%BA%8C%E4%B8%89	將字串以百分號編碼以供URL使用。	1.7+
{{anchorencode:字串}}	{{anchorencode:x y z一二三}} → x_y_z一二三	將字串編碼以供URL錨點（URL中#號後面的部分）使用。	1.8+

命名空間

{{ns:}}返回指定索引編號所對應命名空間的本地名稱。

內容頁面命名空間			討論頁命名空間
用法	輸出		用法	輸出
{{ns:-2}}或{{ns:Media}}	Media		{{ns:-1}}或{{ns:Special}}	Special
{{ns:0}}			{{ns:1}}或{{ns:Talk}}	Talk
{{ns:2}}或{{ns:User}}	User		{{ns:3}}或{{ns:User talk}}	User talk
{{ns:4}}或{{ns:Project}}	Wikibooks		{{ns:5}}或{{ns:Project talk}}	Wikibooks talk
{{ns:6}}或{{ns:File}}或{{ns:Image}}	File		{{ns:7}}或{{ns:File talk}}或{{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
{{ns:100}}或{{ns:Transwiki}}	Transwiki		{{ns:101}}或{{ns:Portal talk}}	Transwiki talk
{{ns:118}}或{{ns:Draft}}			{{ns:119}}或{{ns:Draft talk}}
{{ns:828}}或{{ns:Module}}	Module		{{ns:829}}或{{ns:Module talk}}	Module talk
{{ns:2600}}或{{ns:Topic}}

格式

用法	輸入 → 輸出	描述	版本
{{lc:字串}}	{{lc:DATA CENTER}} → data center	轉換為小寫字母輸出	1.5+
{{lcfirst:字串}}	{{lcfirst:DATA CENTER}} → dATA CENTER	將字串的第一個字元轉換為小寫字母	1.5+
{{uc:字串}}	{{uc:text transform}} → TEXT TRANSFORM	轉換為大寫字母輸出	1.5+
{{ucfirst:字串}}	{{ucfirst:text transform}} → Text transform	將字串的第一個字元轉換為大寫字母	1.5+
{{formatnum:無格式數字}} {{formatnum:格式化的數字|R}}	{{formatnum:-987654321.654321}} → −987,654,321.654321 {{formatnum:-987,654,321.654321|R}} → -987654321.654321	根據本地語言的偏好設定處理空格和逗號等數字分隔符。	1.7+ 1.13+
{{#dateformat:日期}} {{#formatdate:日期}} {{#dateformat:日期|格式}} {{#formatdate:日期|格式}}	{{#dateformat:11 seP 2001|ymd}} → 11 seP 2001（您的偏好設定），2001 SeP 11（預設） {{#formatdate:sep 11,2001|dmy}} → sep 11,2001（您的偏好設定），11 Sep 2001（預設） {{#dateformat:1941-12-07|mdy}} → 12月 7, 1941（您的偏好設定），12月 7, 1941（預設） {{#formatdate:2001 sep 11|ISO 8601}} → 2001 sep 11（您的偏好設定）2001 sep 11（預設）	將日期顯示為用戶在「日期與時間」中所指定的格式。對於未登入或是未進行偏好設定的用戶，可以通過參數指定預設格式：mdy, dmy, ymd, ISO 8601（區分大小寫）。如果未指定格式或格式無效，則輸入格式會被作為預設格式。如果輸入的日期無效，則直接輸出未處理的結果。 解析器函式time提供了更多的格式化控制。	1.15+
{{padleft:xyz|字串長度}} {{padleft:xyz|字串長度|字元}}	{{padleft:xyz|5}} → 00xyz {{padleft:xyz|5|_}} → __xyz	自動在字串開頭用給定的字元（預設為「0」）補足到特定長度。例如{{padleft:44|3|0}}生成044。也用於截取字串的一部分。	1.8+
{{padright:xyz|字串長度}} {{padright:xyz|字串長度|字元}}	{{padright:xyz|5}} → xyz00 {{padright:xyz|5|_}} → xyz__	與padleft類似，但將字元加入到字串的結尾。也用於截取字串的一部分。
{{plural:计数|單數形式|複數形式}}	{{plural:1|他|他們}} → 他	根據首個參數，輸出特定詞語的單數或複數形式（根據中文）。

雜項

魔術字	輸出	描述	版本
{{int:資訊標題}}	{{int:edit}} → 編輯 （根據介面語言而異，嘗試：fr •ja）	根據介面語言版本而顯示特定MediaWiki命名空間訊息的內容。注意：這可能會對快取產生影響。參見bug 14404（已處理）。
{{#language:語言代碼}} {{#language:zh-hk}} {{#language:th}} {{#language:th|zh}}	語言代碼 中文（香港） ไทย 泰語	將ISO 639語言代碼轉換為此種語言的名稱。有第2參數時，以第2參數的語言顯示第1參數的語言名稱。	1.7+
{{#special:特殊頁面名稱}} {{#special:UserLogin}}	Special:特殊頁面名稱 Special:用戶登入	特殊頁面的本地名稱。	1.9+
{{#tag:標籤名}} {{#tag:標籤名 |標籤內容 |屬性=值 |屬性2=值 }}	（依據標籤名確定）	以XML的方式生成標籤，並解析成wiki代碼，有屬性的按照'<tagname attribute="value">' 對應 '{{#tag:tagname|attribute=value}}'編寫，有內容值則按照'<tagname>content</tagname>'對應'{{#tag:tagname|content}}'編寫，用於解決不能標籤巢狀的問題，如ref標籤。	1.12+
{{gender:用戶名稱 |用戶為男性的返回值 |用戶為女性的返回值 |若用戶未指定其性別時的返回值}}	{{gender:Bencmq|他|她|他}} → 他	根據Special:偏好設定中偏好設定的性別進行判斷	1.15+
{{PAGEID}}	25525	返回該頁面ID	1.20+
{{noexternallanglinks}}	{{noexternallanglinks:<语言代码，以管道符分隔>}}	完全禁止某頁面使用維基數據的連結。	使用維基數據庫客戶端外掛程式

參見

• Help:解析器函式
• Language.php的原始碼
• MagicWord.php的原始碼