(创建页面,内容为“ {{操作指南}} {{not|Help:解析器函数}} '''魔术字'''是MediaWiki软件所识别的特定字符串,它们可以返回特定的值或触发其他的功能:比如时间、站点设置或是页面名称等等。此页面只解释标准魔术字的用法。 魔术字有三种常规类型: * '''状态开关''':通常写成以两个下划线为前后缀的大写单词,例如'''<code>__FOO__</code>'''。 * '''#Variables|…”) 標籤:加入魔术字 |
無編輯摘要 |
||
第110行: | 第110行: | ||
|- |
|- |
||
| colspan="2" | <code><nowiki>__STATICREDIRECT__</nowiki></code> |
| colspan="2" | <code><nowiki>__STATICREDIRECT__</nowiki></code> |
||
| 用于一些重定向页面。当有人移动页面并勾选“ |
| 用于一些重定向页面。当有人移动页面并勾选“更新所有指向原始标题的重定向”时,禁止MediaWiki更新本页的重定向(需要变量<code>$wgFixDoubleRedirects</code>)。 |
||
| |
| |
||
|- |
|- |
於 2023年5月30日 (二) 23:36 的修訂
本頁不屬於有獸檔案館的條例或規則;若本頁內容與相關條例不一致的,以條例內容為準。
魔術字是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}}
|
07 | 月(補足前導的0) | |
{{CURRENTMONTH1}}
|
7 | 月(無前導的0) | |
{{CURRENTMONTHNAME}}
|
7月 | 月份名稱 | |
{{CURRENTMONTHNAMEGEN}}
|
7月 | 月份(屬格) | |
{{CURRENTMONTHABBREV}}
|
7月 | 月份(縮寫) | |
日 | |||
{{CURRENTDAY}}
|
2 | 今天是幾日(不補齊) | |
{{CURRENTDAY2}}
|
02 | 今天是幾日(以0補齊) | |
{{CURRENTDOW}}
|
2 | 周內一日(無填充),0(即星期日)到6(即星期六) | |
{{CURRENTDAYNAME}}
|
星期二 | 周內一日(名稱) | |
時間 | |||
{{CURRENTTIME}}
|
23:45 | 時間(24小時制HH:mm的格式) | |
{{CURRENTHOUR}}
|
23 | 時間(24小時制含前導0的數字) | |
其他 | |||
{{CURRENTWEEK}}
|
27 | 第幾周(數字) | |
{{CURRENTTIMESTAMP}}
|
20240702234518 | YYYYMMDDHHmmss時間戳 |
<span class="citation wikicite" id="endnote_{{CURRENTDATE}}
未必是一個魔術字,但可能是一個模板。">[[#ref_{{CURRENTDATE}}
未必是一個魔術字,但可能是一個模板。|^]]
如下變量和上列變量功能相同,但是使用的是所在服務器的時間或者$wgLocaltimezone
。
{{LOCALYEAR}}
{{LOCALMONTH}}
{{LOCALMONTH1}}
{{LOCALMONTHNAME}}
{{LOCALMONTHNAMEGEN}}
{{LOCALMONTHABBREV}}
{{LOCALDAY}}
{{LOCALDAY2}}
{{LOCALDOW}}
{{LOCALDAYNAME}}
{{LOCALTIME}}
{{LOCALHOUR}}
{{LOCALWEEK}}
{{LOCALTIMESTAMP}}
如果需要更詳盡的時間格式,或是在輸出目前年份和星期時更好的遵守ISO-8601,您可以使用#time}}
解析器函數。
技術元數據
變量 | 輸出 | 描述 | 版本 |
---|---|---|---|
站點 | |||
{{SITENAME}}
|
有獸檔案館 | 維基網站的名稱($wgSitename )。
|
|
{{SERVER}}
|
https://youshou.wiki | 域名URL($wgServer ).
|
|
{{SERVERNAME}}
|
youshou.wiki | 子域名和域名(自版本1.17後不再取決於$wgServerName )。
|
|
{{DIRMARK}}
|
|
輸出這個wiki默認語言所使用的Unicode文本方向控制字符(從左到右書寫的語言使用‎ ,反之使用‏ ),這在多方向文本中很有用。它取決於頁面語言。
|
|
{{SCRIPTPATH}}
|
腳本相對路徑($wgScriptPath )。
|
||
{{STYLEPATH}}
|
/skins | 樣式相對路徑($wgStylePath )。
|
|
{{CURRENTVERSION}}
|
1.39.8 (0de4dfa) | 此維基站點的MediaWiki版本。 | |
{{CONTENTLANGUAGE}}
|
zh zh |
默認界面語言($wgLanguageCode )。
|
|
頁面 | |||
{{PAGEID}}
|
9207 | 返回頁面編號。 | |
{{PAGELANGUAGE}} {{#language:{{PAGELANGUAGE}}}}
|
zh 中文 |
返回當前頁面的語言。此變量返回的語言代碼可使用{{#language:...}} 轉換為語言名。
|
|
{{PROTECTIONLEVEL:操作}}
|
輸出當前頁面對於特定行為(比如edit,move)的保護級別(autoconfirm或sysop等)。若未保護則返回空字符串。 | ||
{{PROTECTIONEXPIRY:动作}}
|
根據給出的動作(如edit、move),返回當前頁面的保護信息(例如:時間戳「20160418155030」,或「infinity」) 如果未被保護,則會返回"infinity"。 | ||
{{CASCADINGSOURCES}}
|
[高開銷] 返回當前頁面上的任意連鎖保護操作來源。除非存在自我嵌入,否則頁面將不會返回其各自標題。 | ||
最近一次編輯版本號 | |||
{{REVISIONID}}
|
- | 唯一的版本ID。 在預覽中為空,因此能用來顯示僅限於預覽時的錯誤訊息。可能在吝嗇模式($wgMiserMode )中被停用。
|
|
{{REVISIONDAY}}
|
30 | 最近一次編輯的日期(無前導0)。 | |
{{REVISIONDAY2}}
|
30 | 最近一次編輯的日期(前導0) | |
{{REVISIONMONTH}}
|
05 | 最近一次編輯的月份(有前導0)。 | |
{{REVISIONMONTH1}}
|
5 | 最近一次編輯的月份(沒有前導0)。 | |
{{REVISIONYEAR}}
|
2023 | 最近一次編輯的年份 | |
{{REVISIONTIMESTAMP}}
|
20230530233604 | 最近一次編輯的時間戳。 | |
{{REVISIONUSER}}
|
頂呱呱的阿傑 | 最近一個對指定頁面作出編輯的用戶,或者當前正在對其編輯進行預覽的用戶。 | |
{{REVISIONSIZE}}
|
62239 | 當前版本頁面的大小(維基文本)。 | |
影響頁面內容 | |||
{{DISPLAYTITLE:标题}} {{DISPLAYTITLE:标题|noerror}} {{DISPLAYTITLE:标题|noreplace}}
|
設置當前頁面標題的顯示格式。變量值須與標題等值:只允許對標題的特定部分(不是全部標題)的大小寫變化和用下劃線替換替換空格(這個設定可以通過$wgRestrictDisplayTitle 改變)。可以通過$wgAllowDisplayTitle 將其啟用或禁用;在1.10+前默認禁用,之後的版本中默認啟用。
可以使用第二個參數:「noerror」關閉使用多個本魔術字時導致錯誤消息提示。或「noreplace」如果 |
(以無錯誤提示、不替換為目的) | |
{{DEFAULTSORT:排序关键字}} {{DEFAULTSORTKEY:排序关键字}} {{DEFAULTCATEGORYSORT:排序关键字}} {{DEFAULTSORT:排序关键字|noerror}} {{DEFAULTSORT:排序关键字|noreplace}}
|
在分類頁面上使用,用來設置默認在分類中排序關鍵字。 例如當你將{{DEFAULTSORT:Smith, John}} 放到頁面John Smith的結尾,該頁面在分類頁面上的列表中將默認排到「S」項下。 可以使用第二個參數:「noerror」關閉使用多個本魔術字時導致錯誤消息提示。或「noreplace」如果defaultsort 在前文已經設置,則關閉使用多個本魔術字時導致錯誤消息提示,令defaultsort 失效。
|
(以無錯誤提示、不替換為目的) |
統計
這些變量返回的數字往往包含分隔符(根據本地語言參數設置而可能是逗號或空格)。可以通過「:R」來返回無分隔號的數字(例如{{NUMBEROFPAGES}}
→ 18,506和{{NUMBEROFPAGES:R}}
→ 18506)。
對於PAGESINCATEGORY等需要參數的變量則使用「|R」(例如{{PAGESINCategory:求闻百科分类}}
和{{PAGESINCategory:求闻百科分类|R}}
及{{PAGESINCategory:求闻百科分类|subcats}}
和{{PAGESINCategory:求闻百科分类|subcats|R}}
)。
也適用於上述{{PAGESIZE:页面名称}}
。
返回數字的魔術字數字格式取決於內容語言的設定,取決於頁面內容語言。
變量 | 輸出 | 描述 | 版本 |
---|---|---|---|
{{NUMBEROFPAGES}}
|
18,506 | 維基頁面數量 | |
{{NUMBEROFARTICLES}}
|
617 | 在內容名字空間中,作為條目的頁面個數。 | |
{{NUMBEROFFILES}}
|
2,051 | 上傳文件的個數。 | |
{{NUMBEROFEDITS}}
|
57,276 | 維基編輯的數量 | |
{{NUMBEROFVIEWS}}
|
頁面瀏覽次數。通常對使用緩存的wiki無效。 | ||
{{NUMBEROFUSERS}}
|
394 | 註冊用戶數量 | |
{{NUMBEROFADMINS}}
|
4 | 管理員(sysop)組的用戶數。 | |
{{NUMBEROFACTIVEUSERS}}
|
23 | 活躍用戶總數,其標準與Special:Statistics中的標準相同。 | |
{{PAGESINCATEGORY:分类名称}} {{PAGESINCAT:分类名称}}
|
Template:PAGESINCategory:求聞百科分類 0 |
[高開銷] 指定分類中的頁面總數(包括子類和文件)。(Category:求聞百科分類 在此用於演示) | |
{{PAGESINCATEGORY:分类名称|all}} {{PAGESINCATEGORY:分类名称|pages}} {{PAGESINCATEGORY:分类名称|subcats}} {{PAGESINCATEGORY:分类名称|files}}
|
Template:PAGESINCategory:求聞百科分類 Template:PAGESINCategory:求聞百科分類 Template:PAGESINCategory:求聞百科分類 Template:PAGESINCategory:求聞百科分類 |
[高開銷] 返回指定分類的:
(Category:求聞百科分類 在此用於演示) |
|
{{NUMBERINGROUP:用户组}} {{NUMINGROUP:用户组}}
|
0 0 |
特定用戶組中的用戶總數 (bureaucrat用於演示) | |
{{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 。
如果子頁面不存在將會回傳 如果需要使用更多匹配的話,請使用解析器函數擴充功能的 |
|
{{SUBJECTPAGENAME}} {{ARTICLEPAGENAME}}
|
Help:魔術字 Help:魔術字 |
獲得該頁面的完整頁面名。對討論頁十分有用。 | |
{{TALKPAGENAME}}
|
Help talk:魔術字 | 關聯討論頁的完整頁面名稱 |
這些變量不受 {{DISPLAYTITLE:xxxx}}
影響,它們都會按原來的頁面標題計算返回值。
{{BASEPAGENAME}}
和{{SUBPAGENAME}}
這兩個魔術字只在啟用了子頁面模式的名字空間才生效。關於啟用子頁面模式請看$wgNamespacesWithSubpages
。
以上魔術字可以接受一個參數,用於指定特定頁面,來代替要處理的當前頁面設定:
{{PAGENAME:Template:Main Page}}
→ Main Page
.
」或「..
」的任意部分,魔術字什麼都不返回。
{{PAGENAME:one/./three}}
→ . 不會返回任何東西。
'
、星號*
, 會導致以上魔術字會有不正常的處理結果,如:{{PAGESINCATEGORY:{{PAGENAME}}}}
。一種簡單的修複方法是使用解析器函數擴展的{{#titleparts:}}
來處理標題。
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通過創建(內容為= )來實現。
有關更多說明,請參見幫助:擴展:解析器函數#原始等號。 |
解析器函數
解析器函數與變量相似,但需要一個或多個參數(技術上講,任何需要參數的魔術字都是解析器函數),並且名稱有時以井號(hash)開頭,以與模板區分開來。
此頁面只描述MediaWiki軟件中重要的解析器函數。其他MediaWiki軟件可能添加的解析器函數包括ParserFunctions等。
另一頁面的技術元數據
解析器函數 | 輸出 | 描述 | 版本 |
---|---|---|---|
{{PAGEID: 页面名称 }}
|
0 | [高開銷] 返回指定頁面*的頁面標識符。 | |
{{PAGESIZE:页面名称}} {{PAGESIZE: 页面名称 |R}}
|
0 0 |
[高開銷] 返回特定頁面的字節大小。使用「|R 」獲取原始(未處理)數值。
|
|
頁面名稱}} | [高開銷] 輸出當前頁面對於特定行為(比如edit,move)的保護級別(autoconfirm或sysop等)。若未保護則返回空字符串。 | ||
頁面名稱}} | [高開銷] 根據給出的動作(如edit、move),返回當前頁面的保護信息(例如:時間戳「20160418155030」,或「infinity(無限期)」) 如果未被保護,則會返回"infinity(無限期)"。 | ||
{{CASCADINGSOURCES: page name}}
|
[高開銷] 返回在特定頁面上任意連鎖保護的來源。頁面將不會返回其本身標題,除非頁面有自我嵌入行為。 | ||
{{REVISIONID: 页面名称 }}
|
[高開銷] 當前頁面的最新更改的ID。 | ||
{{REVISIONDAY: 页面名称 }}
|
[高開銷] 指定頁面的最新更改的天* (未補全的數字)。 | ||
{{REVISIONDAY2: 页面名称 }}
|
[高開銷] 指定頁面的最新更改的天* (以0補全的數字)。 | ||
{{REVISIONMONTH: 页面名称 }}
|
[高開銷] 指定頁面的最新修改的月* (以0補全的數字)。 | ||
{{REVISIONMONTH1: 页面名称 }}
|
[高開銷] 指定頁面的最新修改的月* (未補全的數字)。 | ||
{{REVISIONYEAR: 页面名称 }}
|
[高開銷] 指定頁面的最新修改的年*。 | ||
{{REVISIONTIMESTAMP: 页面名称 }}
|
[高開銷] 指定頁面的最新修改的時間截*。 | ||
{{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://youshou.wiki/wiki/Category:Top_level
|
至標題的協議相對路徑,基於本地wiki的$wgServer 設定(且不一定會以http(s):// 開頭)。這也將解決跨wiki前綴。注意:未加括號的(單一)協議相對鏈接不會自動鏈接。
| ||||||||||
{{canonicalurl:页面名称}} {{canonicalurl:页面名称 {{canonicalurl:跨维基前缀:另一维基上的页面名称
|
{{canonicalurl:Category:Top level}} → https://youshou.wiki/wiki/Category:Top_level
|
至標題的絕對路徑,使用規範URL。這也將解決跨wiki前綴。 | ||||||||||
{{filepath:文件名称}} {{filepath:文件名称|nowiki}} {{filepath:文件名称|缩略图大小}}
|
{{filepath:Qiuwen.svg}} →
|
媒體文件的完整大小或縮略圖的協議相對路徑。 | ||||||||||
{{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中,默認值從 |
編碼的輸入用於URL。請注意,沒有像過時的StringFunctions中那樣的urldecode函數
| ||||||||||
{{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}}
|
有獸檔案館 Varies between wikis |
{{ns:5}} / {{ns:Project talk}}
|
有獸檔案館 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 |
不要將本地化名字空間與自定義名字空間相混淆。
格式化
用法 | 輸入 → 輸出 | 描述 | 版本 |
---|---|---|---|
|
不被支持的: 錯誤輸入(不可靠輸出)的示例,有或沒有 |
採用未格式化的數字(例如阿拉伯語數字,沒有組分隔符和. 作為小數分隔符)並將其輸出到本地化的數字腳本中,並使用十進制和十進制組分隔符進行格式化,到wiki的默認語言環境。
開頭的前導零不會被去除;可以使用 {{#expr:00001}} 來去除。如果你沒有準確地以需求的數字格式輸入,則難以得到任何可靠的輸出,尤其是在非英文的維基上。 如果你真的需要輸入一個無法保證格式正確的數字(根據Wiki的語言環境)的話,你可以使用 |
|
|
|
根據用戶的「日期格式」設置格式化給定日期,並添加將其標記為格式化日期的元數據。對於未登錄的遊客和沒有在設置中指定日期格式的用戶,日期可以按以下默認格式給定:mdy 、dmy 、ymd 、ISO 8601 (大小寫敏感)。如果只給定了月份和日期的話,只有 mdy 和 dmy 是合法格式。如果未給定日期格式或日期格式不合法,則輸入格式將用作為默認格式。如果提供的日期未被識別為有效日期(特別是,如果它包含任何元數據,例如來自另一個 dateformat 或類似模板的嵌套使用),則將其保持不變,並且不會生成額外的元數據。 即使ISO 8601格式要求參數1的日期是公曆日期,若參數2指定ISO 8601,函數也能對那些超出通常公曆範圍的日期進行格式化(例如1583年之前的日期)。不過,函數無法正確轉換ISO 8601格式下的負數年份和通常格式下的公元前的年份。 |
|
|
{{lc:DATA CENTER}} → data center
|
小寫輸入。 | |
|
{{lcfirst:DATA center}} → dATA center
|
輸入的內容會強制將首字母小寫化。 | |
|
{{uc:text transform}} → TEXT TRANSFORM
|
大寫輸入。 | |
|
{{ucfirst:text tRAnSFORM}} → Text tRAnSFORM
|
輸入的內容會強制將首字母大寫化。 | |
|
{{padleft:xyz|5}} → 00xyz
|
將參數1通過在左側補上參數3指定的字符串(默認為0)補足到參數2指定的長度。 例如 {{padleft:44|3|0}} 生成 044。 參數3指定的字符串可能被截斷以保證補足後的字符串長度滿足要求。
在 1.12 版本以前,第三個參數只使用傳入的字符串的第一個字符,但從 1.15 版本以後,第三個參數傳入的字符串的所有字符都會被使用。 |
|
|
{{padright:xyz|5}} → xyz00
|
除了在右側補上字符串外,其他與 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=Категория|Категории}} → Категории
|
根據參數1是單數還是複數,輸出不同的字符串:單數輸出參數2,複數輸出參數3。它的表現是與界面語言相關的。
[[#ref_一些語言(ab、av、ba、bxr、ce、crh_cyrl、cv、inh、koi、krc、kv、lbe、lez、mhr、mrj、myv、ru、tt_cyrl、tyv、udm、xal)使用3種複數形式
|
|
{{grammar:N|noun}}
|
根據分號後的詞形變化代碼輸出給定的詞的正確的詞形變化。語法變形被用于波蘭語這樣的屈折語。參見 $wgGrammarForms 。
|
||
{{gender:username|text for every gender}}
|
(取決於指定用戶的性別) | 根據指定的用戶的設置返回該性別對應的文本。 注意: 第一個例子基本上啥也沒幹 |
|
{{int:消息名称}}
|
{{int:edit}} → 編輯 (取決於用戶語言,可以試試:fr • ja) |
該解析器函數將會把(MediaWiki命名空間下的)界面消息翻譯成用戶語言。msgnw 和其他嵌套引用魔術字參見嵌入修改器一節。注意在1.17版本以前,這麼做會導致緩存一致性被破壞。
|
|
{{int:editsectionhint|MediaWiki}}
|
{{int:editsectionhint|MediaWiki}} → 編輯章節:MediaWiki
|
你可以在翻譯過程中使用參數。 界面消息里的參數使用 $1、$2、$3 來引用 例如,editsectionhint界面消息的源碼為:編輯章節:$1 在左側例子中,MediaWiki 替換了 $1。 |
嵌入修改器
{{页面名|可选参数}}
默認從 Template: 命名空間嵌入頁面。
這些魔術字會修改此行為。
用法 | 描述 | 版本 | |
---|---|---|---|
{{:xyz}}
|
裸冒號不是模板修飾符,而是主命名空間的前綴。 由於嵌入默認為模板命名空間,因此您可以使用{{:UTC}}(與{{UTC}})來包含主名字空間條目UTC的文本而不是Template:UTC。 | ||
{{int:xyz}}
|
除了會根據內容/用戶/uselang指定的語言來使用子頁面以進行標準消息翻譯外,其他與 {{MediaWiki:xyz}} 一致。 另一個區別在於,使用本函數後不會在「該頁面使用的模板:」出現模板名(即界面消息名)。 如果MediaWiki:xyz不存在則渲染為⧼xyz⧽。 | ||
{{msg:xyz}} {{raw:xyz}}
|
即使有魔術字同名也會優先以模板名考慮,除非對應的模板不存在(等同於 {{template:xyz}}) 通常來說,當存在衝突時,會優先以魔術字名考慮。 | ||
{{raw:xyz}}
|
如果開啟了$wgEnableScaryTranscluding ,那麼將會在跨維基的嵌套引用中不引用來自對方站點的預渲染HTML而是引用wikitext源碼。
|
||
{{msgnw:xyz}}
|
呈現未展開的wiki文本(或多或少)。 | ||
{{subst:xyz}}
|
在wikitext中,該函數將會被替換成模板文本(僅單層展開)。 | ||
{{safesubst:xyz}}
|
雜項
用法 | 輸入 → 輸出 | 描述 | 版本 |
---|---|---|---|
{{#language:语言代码}} {{#language:语言代码|目标语言代码}}
|
{{#language:ar}} → العربية {{#language:ar|en}} → Arabic
|
以參數2的語言代碼指定的語言(沒有則以參數1的)輸出參數1的語言代碼對應的語言全名:默認為本地化名稱(語言別名),當指定了目標語言代碼時會輸出目標語言翻譯版本。 | (翻譯) |
{{#special:特殊页面名}}
|
{{#special:userlogin}} → Special:用戶登錄
|
給定規範Special:頁面的本地化名稱。 | |
{{#speciale:特殊页面名}}
|
{{#speciale:userlogin}} → Special:%E7%94%A8%E6%88%B7%E7%99%BB%E5%BD%95
|
給定規範Special:頁面的本地化和URL編碼名稱。 | |
{{#tag:标签名称
|
例如Cite擴展的<ref> 標籤:
參考資料
|
XML格式的MediaWiki解析器標籤或擴展標籤的別名。 此魔術字允許[wiki代碼的預保存轉換,和在此標籤被處理之前的標籤內部的解析器函數。 這也會防止在尚未執行的判斷路徑中解析標籤(如在#if 中)。 標籤之間的內容作為第一個參數傳遞,其他任何屬性則作為後續的參數傳遞。 例如:
…能夠像這樣被重寫:
必須寫成這種形式才能使內容為空: {{#tag:tagnameTemplate:!!attribute1=值1|attribute2=值2}} 。在attribute1之前的管道字符|| 之間,不允許有文本內容的前導或尾部空格。 |
有關解析器函數#invoke,見Lua幫助文檔。