Help:魔术字

(重定向自Wikipedia:魔術字
维基百科使用手册

这是一个用于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}} 23 日(无前导零)
{{CURRENTDAY2}} 23 日(补足前导零) 1.6+
星期
{{CURRENTDOW}} 6 星期(数字格式)
{{CURRENTDAYNAME}} 星期六 星期
时间
{{CURRENTTIME}} 16:42 时间(24小时制,格式为HH:mm)
{{CURRENTHOUR}} 16 时间(24小时制,有前导零)
其他
{{CURRENTWEEK}} 47 周数
{{CURRENTTIMESTAMP}}
(相當於{{#time:YmdHis}}
20241123164226 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,872,467而{{NUMBEROFPAGES:R}}→7872467))。对于PAGESINCATEGORY等需要参数的变量则使用“|R”(例如{{PAGESINCATEGORY:Help}}→0而{{PAGESINCATEGORY:Help|R}}→0)。

变量 输出 描述 版本
整个站点
{{NUMBEROFPAGES}} 7,872,467 页面总数 1.7+
{{NUMBEROFARTICLES}} 1,451,901 主命名空间(條目命名空間)内的页面总数
{{NUMBEROFFILES}} 68,290 上传的文件总数 1.5+
{{NUMBEROFEDITS}} 84,764,188 总页面编辑次数 1.10+
{{NUMBEROFVIEWS}} 页面浏览次数。通常对使用缓存的wiki无效。 1.14~1.24
{{NUMBEROFUSERS}} 3,621,787 注册用户总数 1.7+
{{NUMBEROFADMINS}} 65 sysop用户组中的用户总数 1.7+
{{NUMBEROFACTIVEUSERS}} 7,116 活跃用户总数,其标准与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月23日 (六) 16:42 (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:16+8}} 24 使用“#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

外部链接