說明:魔術字
| 維基教科書使用手冊：索引 · 關於 · 閱讀 · 編輯 · 管理 · 開發 · 附錄 · 元說明（簡體 · 繁體） |
MediaWiki中的相關條目：
這是一個用於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}} | 11 | 月（補足前導零） | |
| {{CURRENTMONTHNAME}} | 11月 | 月（本地語言中的月份名稱） | |
| {{CURRENTMONTHNAMEGEN}} | 11月 | 月（本地語言中月份名稱的屬格形式） | |
| {{CURRENTMONTHABBREV}} | 11月 | 月（本地語言中月份名稱的簡稱） | 1.5+ |
| 日 | |||
| {{CURRENTDAY}} | 25 | 日（無前導零） | |
| {{CURRENTDAY2}} | 25 | 日（補足前導零） | 1.6+ |
| 星期 | |||
| {{CURRENTDOW}} | 1 | 星期（數字格式） | |
| {{CURRENTDAYNAME}} | 星期一 | 星期 | |
| 時間 | |||
| {{CURRENTTIME}} | 00:55 | 時間（24小時制，格式為HH:mm） | |
| {{CURRENTHOUR}} | 00 | 時間（24小時制，有前導零） | |
| 其他 | |||
| {{CURRENTWEEK}} | 48 | 周數 | |
| {{CURRENTTIMESTAMP}} | 20241125005550 | 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.4 （a8dd895） | 當前所使用的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,234而{{NUMBEROFPAGES:R}}→19234)）。對於PAGESINCATEGORY等需要參數的變數則使用「|R」（例如{{PAGESINCATEGORY:Help}}及{{PAGESINCATEGORY:Help|R}}）。
| 變數 | 輸出 | 描述 | 版本 |
|---|---|---|---|
| 整個站點 | |||
| {{NUMBEROFPAGES}} | 19,234 | 頁面總數 | 1.7+ |
| {{NUMBEROFARTICLES}} | 3,718 | 主命名空間內的頁面總數 | |
| {{NUMBEROFFILES}} | 102 | 上傳的檔案總數 | 1.5+ |
| {{NUMBEROFEDITS}} | 178,776 | 總頁面編輯次數 | 1.10+ |
| {{NUMBEROFVIEWS}} | 頁面瀏覽次數。通常對使用快取的wiki無效。 | 1.14～1.24 | |
| {{NUMBEROFUSERS}} | 66,177 | 註冊用戶總數 | 1.7+ |
| {{NUMBEROFADMINS}} | 8 | sysop用戶組中的用戶總數 | 1.7+ |
| {{NUMBEROFACTIVEUSERS}} | 39 | 活躍用戶總數，其標準與Special:Statistics中的標準相同 | 1.15+ |
| {{PAGESINCATEGORY:分類標題}} {{PAGESINCAT:帮助文档}} |
4 |
[高開銷]指定分類中的頁面總數。 | 1.13+ |
|
{{PAGESINCATEGORY:帮助文档|all}} |
4 |
[高開銷]返回指定分類的：
|
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}} → |
指定標題的絕對路徑，同時處理跨維基字首。 | 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:11 seP 2001|ymd}} |
將日期顯示為用戶在「日期與時間」中所指定的格式。對於未登入或是未進行偏好設定的用戶，可以通過參數指定預設格式：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:<语言代码，以管道符分隔>}} | 完全禁止某頁面使用維基數據的連結。 | 使用維基數據庫客戶端外掛程式 |
參見
編輯
| ||||||||||||||||||||