說明:魔術字

維基百科使用手冊

這是一個用於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}},參見Wikipedia:消歧義 使用消歧義外掛程式

變數

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

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

日期與時間

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

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

變數 輸出 描述 版本
{{CURRENTYEAR}} 2024
{{CURRENTMONTH}} 11 月(補足前導零)
{{CURRENTMONTHNAME}} 11月 月(本地語言中的月份名稱)
{{CURRENTMONTHNAMEGEN}} 11月 月(本地語言中月份名稱的屬格形式)
{{CURRENTMONTHABBREV}} 11月 月(本地語言中月份名稱的簡稱) 1.5+
{{CURRENTDAY}} 27 日(無前導零)
{{CURRENTDAY2}} 27 日(補足前導零) 1.6+
星期
{{CURRENTDOW}} 3 星期(數字格式)
{{CURRENTDAYNAME}} 星期三 星期
時間
{{CURRENTTIME}} 12:02 時間(24小時制,格式為HH:mm)
{{CURRENTHOUR}} 12 時間(24小時制,有前導零)
其他
{{CURRENTWEEK}} 48 周數
{{CURRENTTIMESTAMP}}
(相當於{{#time:YmdHis}}
20241127120208 YYYYMMDDHHmmss時間戳 1.7+

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

  • {{LOCALYEAR}}
  • {{LOCALMONTH}}
  • {{LOCALMONTHNAME}}
  • {{LOCALMONTHNAMEGEN}}
  • {{LOCALMONTHABBREV}}
  • {{LOCALDAY}}
  • {{LOCALDAY2}}
  • {{LOCALDOW}}
  • {{LOCALDAYNAME}}
  • {{LOCALTIME}}
  • {{LOCALHOUR}}
  • {{LOCALWEEK}}
  • {{LOCALTIMESTAMP}}
對於更詳細的時間格式,請參見Help:時間序號

技術元數據

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

變數 輸出 描述 版本
站點
{{SITENAME}} Wikipedia 站點名稱($wgSitename
{{SERVER}} //zh.wikipedia.org 域名URL$wgServer
{{SERVERNAME}} zh.wikipedia.org 域名名稱($wgServerName
{{DIRMARK}}
{{DIRECTIONMARK}}

輸出這個wiki預設語言所使用的Unicode文字方向控制字元(從左到右書寫的語言使用‎,反之使用‏ 1.7+
{{SCRIPTPATH}} /w 相對指令碼路徑($wgScriptPath
{{CURRENTVERSION}} 1.44.0-wmf.4 (a8dd895) 當前所使用的MediaWiki版本 1.7+
{{CONTENTLANGUAGE}}
{{CONTENTLANG}}
zh
zh
預設的介面語言($wgLanguageCode 1.7+
當前頁面的最新編輯版本
{{REVISIONID}}
{{REVISIONID:页面标题}}
-
 
最近一次編輯版本的ID,然而在Miser模式下只會顯示為連字暨減號
[高開銷] 指定頁面最近修訂版本的ID
1.5+
1.16+
{{REVISIONDAY}}
{{REVISIONDAY:页面标题}}
11
 
最近一次編輯的日份
[高開銷] 指定頁面最近一次編輯的日份
1.8+
1.16+
{{REVISIONDAY2}}
{{REVISIONDAY2:页面标题}}
11
 
最近一次編輯的日份(前導零)
[高開銷] 指定頁面最近一次編輯的日份
1.8+
1.16+
{{REVISIONMONTH}}
{{REVISIONMONTH:页面标题}}
09
 
最近一次編輯的月份
[高開銷] 指定頁面最近一次編輯的月份
1.8+
1.16+
{{REVISIONYEAR}}
{{REVISIONYEAR:页面标题}}
2024
 
最近一次編輯的年份
[高開銷] 指定頁面最近一次編輯的年份
1.8+
1.16+
{{REVISIONTIMESTAMP}}
{{REVISIONTIMESTAMP:页面标题}}
20240911012119
 
最近一次編輯的時間戳
[高開銷] 最近修訂版本的時間戳
1.8+
1.16+
{{REVISIONUSER}}
{{REVISIONUSER:页面标题}}
Cwek
 
最近一個對本頁面作出編輯的用戶
[高開銷] 最近一個對指定頁面作出編輯的用戶
在編輯提示里顯示即將編輯的用戶,見[1]
1.15+
1.16+
{{PAGESIZE:页面标题}}
{{PAGESIZE:Help:魔术字}}

110
[高開銷] 返回指定頁面的大小 1.13+
{{PROTECTIONLEVEL:行为}} 保護級別 輸出當前頁面對於特定行為(create,edit或move)的保護級別(autoconfirm或sysop等)。若未保護則返回空字串。 1.15+
影響頁面內容
{{DISPLAYTITLE:标题}} 變更頁面的標題,與-{T|}-類似,但優先級高於後者,不推薦使用,建議使用具有字詞轉換的{{DISPLAYTITLE}}代替。可以通過$wgAllowDisplayTitle將其啟用或禁用。在1.10+前預設禁用,之後的版本中預設啟用。 1.7+
{{DEFAULTSORT:排序索引}}
{{DEFAULTSORTKEY:排序索引}}
{{DEFAULTCATEGORYSORT:排序索引}}
為頁面設定一個預設的排序索引。例如在吉米·威爾士條目的結尾加入{{DEFAULTSORT:Wales, Jimmy}},則預設此條目在所有分類中都會排在「W」下,而非「吉」。 1.10+

統計

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

變數 輸出 描述 版本
整個站點
{{NUMBEROFPAGES}} 7,875,028 頁面總數 1.7+
{{NUMBEROFARTICLES}} 1,452,287 主命名空間(條目命名空間)內的頁面總數
{{NUMBEROFFILES}} 68,321 上載的檔案總數 1.5+
{{NUMBEROFEDITS}} 84,806,243 總頁面編輯次數 1.10+
{{NUMBEROFVIEWS}} 頁面瀏覽次數。通常對使用快取的wiki無效。 1.14~1.24
{{NUMBEROFUSERS}} 3,623,786 註冊用戶總數 1.7+
{{NUMBEROFADMINS}} 65 sysop用戶組中的用戶總數 1.7+
{{NUMBEROFACTIVEUSERS}} 7,077 活躍用戶總數,其標準與Special:Statistics中的標準相同 1.15+
{{PAGESINCATEGORY:分类标题}}
{{PAGESINCAT:帮助文档}}

159
[高開銷] 指定分類中的頁面總數。 1.13+

{{PAGESINCATEGORY:帮助文档|all}}
{{PAGESINCATEGORY:帮助文档|pages}}
{{PAGESINCATEGORY:帮助文档|subcats}}
{{PAGESINCATEGORY:帮助文档|files}}

159
142
17
0

[高開銷] 返回指定分類的:
  • 所有頁面數
  • 所有非分類頁和非檔案頁數
  • 所有子分類頁數
  • 所有檔案頁數
1.20+
{{NUMBERINGROUP:用户群组}}
{{NUMINGROUP:用户群组}}
{{NUMBERINGROUP:bureaucrat}}
8
特定用戶群組中的用戶總數 1.14+
{{PAGESINNS:索引编号}}
{{PAGESINNAMESPACE:索引编号}}
禁用 指定命名空間中的頁面總數。例如{{PAGESINNAMESPACE:14}}返回分類總數。在中文維基百科被禁用。 1.7+
{{NUMBEROFCONTRIBS:用户名}} 禁用 指定用戶的貢獻總數。在中文維基百科疑似被禁用。 1.16+

頁面標題

變數 輸出 描述 版本
{{FULLPAGENAME}} Help:魔術字 命名空間及頁面標題 1.6+
{{PAGENAME}} 魔術字 頁面標題
{{BASEPAGENAME}} 魔術字 頁面標題,不包括當前子頁面標題及命名空間(頁面「Wikipedia:頁面/子頁面/子頁面的子頁面」則返回「頁面/子頁面」) 1.7+
{{ROOTPAGENAME}} 魔術字 獲得當前頁面的根頁名,不包括所有子頁面標題及命名空間(頁面「Wikipedia:頁面/子頁面/子頁面的子頁面」則返回「頁面」)
{{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+
{{=}} = 在參數中代替 = phab:T91154
#REDIRECT [[條目名稱]]
#重定向 [[條目名稱]]
標記此條目為重新導向頁。此語法僅在條目第一行時有效。另見Help:重新導向
ISBN 0-12-345678-9 ISBN 0-12-345678-9 同樣是MediaWiki軟件所辨識的特定字串,並且符合條件時會自動轉換為連結。目前中文維基百科支援的此類魔術語法有ISBNPMID以及RFC。參見Help:魔術連結

自動替換引用的符號

部分特殊符號或魔術字會在儲存編輯的當下自動替換引用(見過濾器紀錄的原始編輯內容Special:濫用紀錄檔/3876535與實際儲存後的編輯內容Special:Diff/67182296),部分功能可利用<includeonly></includeonly>標籤包裹來防止轉換,部分功能要透過其他符號將之斷開才能防止轉換。

變數 輸出 描述 版本
'"`UNIQ--擴展標籤名稱-實體編號-QINU`"'[1] (依實際實體標籤而定) 若儲存的原始碼內容中直接存在此字串且存在對應編號的擴充功能標籤實體,則會自動被替換為對應擴充功能標籤內容[2]。此外所有擴充功能標籤在模板解析處理過程中皆會以此種特殊符號儲存,這也是使用{{#ifeq:}}比較兩個內容相同且包含擴充功能標籤(如<math><nowiki><ref>等)的字串會失敗的原因。另見mw:Strip marker。這個自動替換引用的過程在<includeonly></includeonly>標籤內不起作用[3] 1.26+
~~~ (因用戶而異) 自動替換為用戶的簽名。另見WP:簽名
~~~~ (因用戶而異) 自動替換為用戶的簽名及時間。另見WP:簽名
~~~~~ 2024年11月27日 (三) 12:02 (UTC) 自動替換為儲存編輯時的時間。另見WP:簽名

解析器函數

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

這一頁僅列出了整合在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:跨维基链接:页面标题|字符串}}
//zh.wikipedia.org/wiki/Category:%E5%B8%AE%E5%8A%A9%E6%96%87%E6%A1%A3

//zh.wikipedia.org/w/index.php?title=Category:%E5%B8%AE%E5%8A%A9%E6%96%87%E6%A1%A3&action=edit
https://en.wikipedia.org/wiki/Category:Help?action=edit

指定標題的絕對路徑,同時處理跨維基字首。 1.5+
{{filepath:文件名}}
{{filepath:文件名|nowiki}}
//upload.wikimedia.org/wikipedia/zh/b/bc/Wiki.png
//upload.wikimedia.org/wikipedia/zh/b/bc/Wiki.png
指定多媒體檔案的絕對路徑 1.12+
{{urlencode:字 符 串}}
{{urlencode:x y z 一二三}}
%E5%AD%97+%E7%AC%A6+%E4%B8%B2
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}} Wikipedia {{ns:5}}{{ns:Project talk}} Wikipedia 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:Portal}} Portal {{ns:101}}{{ns:Portal talk}} Portal talk
{{ns:102}}{{ns:WikiProject}} WikiProject {{ns:103}}{{ns:WikiProject talk}} WikiProject talk
{{ns:118}}{{ns:Draft}} Draft {{ns:119}}{{ns:Draft talk}} Draft talk
{{ns:126}}{{ns:MOS}} MOS {{ns:127}}{{ns:MOS talk}} MOS talk
{{ns:828}}{{ns:Module}} Module {{ns:829}}{{ns:Module talk}} Module talk
不適用 不適用 {{ns:2600}}{{ns:Topic}} 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:MediaWiki:命名空間下的頁面標題}} {{int:edit}}編輯本頁
(根據介面語言而異,嘗試:frja
根據介面語言版本而顯示特定MediaWiki命名空間訊息的內容。注意:這可能會對快取產生影響。參見bug 14404(已處理)。
{{#language:语言代码}}
{{#language:zh-hk}}
{{#language:th}}
{{#language:th|zh}}
語言代碼
中文(香港)
ไทย
泰語
ISO 639語言代碼轉換為此種語言的名稱。有第2參數時,以第2參數的語言顯示第1參數的語言名稱。 1.7+
{{#special:特殊页面名称}}
{{#special:UserLogin}}
Special:特殊頁面名稱
Special:用戶登入
特殊頁面的本地名稱,可用{{special|特殊页面名称}}替換。 1.9+
{{#tag:标签名}}
{{#tag:标签名|标签内容}}
{{#tag:标签名
|标签内容|属性1=值
|属性2=值
}}
(依據標籤名確定) 以XML的方式生成標籤,並解析成wiki代碼,有屬性的按照<tagname attribute="value">對應{{#tag:tagname|attribute=value}}編寫,有內容值則按照<tagname>content</tagname>對應{{#tag:tagname|content}}編寫,用於解決不能標籤巢狀的問題,如ref標籤。 1.12+
{{gender:用户名
|用户为男性的返回值
|用户为女性的返回值
|若用户未指定其性别时的返回值}}
{{gender:Bencmq|他|她|TA}} → 他 根據Special:偏好設定中設定的性別進行判斷 1.15+
{{groupconvert:转换组名称}} 啟用MediaWiki:Groupconversiontable-''转换组名称''/''语言代码''中定義的字詞轉換。但中文維基百科現使用{{NoteTA}},因此無反應。 1.15+
{{PAGEID}} 1048886 返回該頁面ID 1.20+
{{noexternallanglinks}} {{noexternallanglinks:<语言代码,以管道符分隔>}} 完全禁止某頁面使用維基數據的連結。 使用維基數據庫客戶端外掛程式

藉助魔術字呼叫解析器函數

魔術字 輸出 描述
{{#xyz:主參數|副參數}} 調用名為xyz的解析器函數。關於中文維基百科能用的所有解析器函數詳見Special:版本#mw-version-parser-function-hooks。另見Help:解析器函數
{{#expr:12+8}} 20 使用「#expr」對數值進行計算
{{#expr:floor(100*24/217)}}% 11% 使用「#expr」及「floor」的計算
{{#if:檢查字串|有值時輸出|無值時輸出}}
{{#if|yes|no}}
{{#if:foo|yes|no}}
有值時輸出
no
yes
檢查輸入是否有值
{{#ifeq:a|b|相等|不相等}}
{{#ifeq:a|a|相等|不相等}}
不相等
相等
檢查兩輸入是否相等
{{#property:P361}} MediaWiki 使用解析器函數調用維基數據的資料,其中P361代表本頁面的所屬實體,MediaWiki。詳細使用說明見維基數據的相關說明
{{#invoke:模組名稱|函數名稱}} 使用解析器函數調用模組命名空間中的函數。詳細使用說明見WP:Lua

嵌入包含修飾詞

{{頁面名稱|可選參數}}通常會嵌入包含其他頁面的內容,預設是嵌入包含自Template:模板命名空間。

嵌入包含修飾詞類的魔術字可以改變嵌入包含時的行為。

以上任何以{{魔術字名稱}}{{#魔術字名稱}}調用的魔術字,皆可以使用這些修飾詞進行調整。

用法 輸出 說明 版本
{{:xyz}} 非來自預設Template:模板命名空間的嵌入包含 表示變更嵌入包含命名空間的語法。單一冒號一般不會視為模板修飾詞,而是條目命名空間的前綴。 由於嵌入包含預設是使用Template命名空間,因此您可以使用{{:UTC}}(s. {{UTC}})來包含主命名空間條目UTC的內文,而不是{{UTC}}。
{{int:xyz}} 介面語言訊息的內容 表示介面語言版本而顯示特定MediaWiki命名空間訊息的內容。同於{{MediaWiki:xyz}}, except standard message translation is applied depending on subpages and content/user/uselang language. Another difference is: this doesn't appear under "本頁嵌入包含了$1個頁面:". Rendered as ⧼xyz⧽ if MediaWiki:xyz doesn't exist. See also mw:Help:System message.
{{msg:xyz}} 優先參照模板內容 表示以嵌入包含為優先。 若存在一個名為"xyz"的魔術字,僅要使用msg:魔術字修飾詞,則會以template:xyz為優先(與{{template:xyz}}等價)。 一般情況下,若無使用本魔術字修飾詞,且模板名稱與魔術字衝突時,會以魔術字為優先。
{{raw:xyz}} 僅使用模板內容 表示只做嵌入包含。 在中文維基百科的一般情況下,使用msg:與使用raw:魔術字修飾詞相同。然而在$wgEnableScaryTranscluding有啟用的維基中,此魔術字修飾詞可以實現跨維基參照,並且會參照其他維基媒體網站的維基代碼,而非純粹的HTML碼。 Template:MW version
{{msgnw:xyz}} 僅模板原使碼,不做解析 表示只做嵌入包含,不做維基代碼的解析。 使用此魔術字修飾詞會輸出未展開的維基代碼,包含<nowiki><noinclude><includeonly><onlyinclude>等代碼都會原封不動地輸出。唯須注意的是,此結果輸入到Lua模組內會以HTML entities的方式表示。 (more or less, for details see mw:Help:Template#Usage).
{{subst:xyz}} 替換參照結果。 In the wikitext, the tag is substituted by the content (single-level evaluation only), see Help:替換參照.
{{safesubst:xyz}} 替換參照結果或嵌入包含。 有例外處理的替換參照。使用一般subst魔術字修飾詞時,若替換參照失敗則會變為未解析模式如{{subst:xyz}},然而若使用safesubst魔術字修飾詞替換參照失敗則會變為普通的嵌入包含模式,即若{{subst:xyz}}失敗了,則會改為輸出{{xyz}}。另請參考mw:Help:Template#Usage

特殊的嵌入包含方式

用法 輸出 說明 版本
{{special:xyz}} 顯示特殊頁面內容於目標位置 顯示特殊頁面內容的語法。僅能顯示特殊頁面內容,不支援Help:替換參照。對此類嵌入包含使用msg、raw、msgnw和safesubst的效果與未使用修飾詞時是相同的。目前支援嵌入包含的特殊頁面有Special:AllPagesSpecial:PrefixIndexSpecial:NewFilesSpecial:NewPagesSpecial:RecentChanges以及Special:RecentChangesLinked
{{/xyz}} 嵌入相對的子頁面 嵌入以此頁面為準的相對路徑之子頁面,以{{/xyz}}為例,在此頁的效果等同於{{Help:魔术字/xyz}}
{{#lst:xyz|foo}} 嵌入對應頁面中被<section>標籤標記的內容。 嵌入在對應頁面中,包覆於<section begin=foo/>與<section end=foo/>之間的內容,支援替換參照,但不支援模板參數套用。目前用於WP:AFD等討論的集中討論區。建議在條目中使用{{Excerpt}}模板,而不是此魔術字,以引導貢獻者到原始頁面編輯來促進合作。
{{#lstx:xyz|foo}} 嵌入對應頁面中除了{{#lst:xyz|foo}}之外的內容 嵌入在對應頁面中除了{{#lst:xyz|foo}}之外的內容,並可以透過{{#lstx:xyz|foo|要替換的內容}}將對應內容以替代內容顯示。支援替換參照,但不支援模板中參數的參照。
{{#lsth:xyz|章節1|章節2}} 嵌入對應頁面中的特定章節 嵌入在對應頁面中的特定章節,若未填寫章節,則顯示首段或導言。支援替換參照,但不支援模板中參數的參照。建議在條目中使用{{Excerpt}}模板,而不是此魔術字,以引導貢獻者到原始頁面編輯來促進合作。

參見

註釋

  1. ^ 「␡」須改輸入為ASCII版本的字元才會生效,例如?'"`UNIQ--math-00000002-QINU`"'?(需在編輯模式複製才有效),見測試樣例
  2. ^ 見過濾器紀錄的原始編輯內容Special:濫用紀錄檔/3875674與實際儲存後的編輯內容Special:Diff/67174865
  3. ^ 見過濾器紀錄的原始編輯內容Special:濫用紀錄檔/3875681與實際儲存後的編輯內容Special:Diff/67174958

外部連結