帮助:魔术字

维基百科使用手册 索引 关于 阅读 编辑 管理 开发 附录 元帮助

这是一个用于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}}	18:36	时间（24小时制，格式为HH:mm）
{{CURRENTHOUR}}	18	时间（24小时制，有前导零）
其他
{{CURRENTWEEK}}	47	周数
{{CURRENTTIMESTAMP}} （相当于{{#time:YmdHis}}）	20241123183631	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,523而{{NUMBEROFPAGES:R}}→7872523)）。对于PAGESINCATEGORY等需要参数的变量则使用“|R”（例如{{PAGESINCATEGORY:Help}}→0而{{PAGESINCATEGORY:Help|R}}→0）。

变量	输出	描述	版本
整个站点
{{NUMBEROFPAGES}}	7,872,523	页面总数	1.7+
{{NUMBEROFARTICLES}}	1,451,910	主命名空间（条目命名空间）内的页面总数
{{NUMBEROFFILES}}	68,295	上传的文件总数	1.5+
{{NUMBEROFEDITS}}	84,764,952	总页面编辑次数	1.10+
{{NUMBEROFVIEWS}}		页面浏览次数。通常对使用缓存的wiki无效。	1.14～1.24
{{NUMBEROFUSERS}}	3,621,824	注册用户总数	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软件所识别的特定字符串，并且符合条件时会自动转换为链接。目前中文维基百科支持的此类魔术语法有ISBN、PMID以及RFC。参见Help:魔术链接。

自动替换引用的符号

部分特殊符号或魔术字会在存储编辑的当下自动替换引用（见过滤器记录的原始编辑内容Special:滥用日志/3876535与实际存储后的编辑内容Special:Diff/67182296），部分功能可利用<includeonly></includeonly>标签包裹来防止转换，部分功能要通过其他符号将之断开才能防止转换。

变量	输出	描述	版本
␡'"`UNIQ--擴展標籤名稱-實體編號-QINU`"'␡	(依实际实体标签而定)	若存储的源代码内容中直接存在此字符串且存在对应编号的扩展标签实体，则会自动被替换为对应扩展标签内容。此外所有扩展标签在模板解析处理过程中皆会以此种特殊符号存储，这也是使用{{#ifeq:}}比较两个内容相同且包含扩展标签（如<math>﹑<nowiki>或<ref>等）的字符串会失败的原因。另见mw:Strip marker。这个自动替换引用的过程在<includeonly></includeonly>标签内不起作用	1.26+
~~~	(因用户而异)	自动替换为用户的签名。另见WP:签名。
~~~~	(因用户而异)	自动替换为用户的签名及时间。另见WP:签名。
~~~~~	2024年11月23日 (六) 18:36 (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}} → 编辑本页 （根据界面语言而异，尝试：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:用户登录	特殊页面的本地名称，可用{{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:18+8}}	26	使用“#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:AllPages、Special:PrefixIndex、Special:NewFiles、Special:NewPages、Special: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}}模板，而不是此魔术字，以引导贡献者到原始页面编辑来促进合作。

参见

• Help:解析器函数

外部链接

• MagicWord.php的源代码