Help:魔术字

（参见Mediawiki上的Help:Magic Words） 本页面说明的魔术字均为Mediawiki对应页面上所列举出来的全部的魔术字，由于软件版本的问题不一定都能生效。你维目前（编辑时）使用的Mediawiki版本为1.39.5。如果该魔术字在当前版本不能使用，会使用删除线。

魔术字（Magic words）是MediaWiki软件所识别的特定字符串，它们可以返回特定的值或触发其他的功能：比如时间、站点设置或是页面名称等等。

魔术字有以下三种类型：

状态开关：通常写成用两个下划线为前后缀的全大写单词，例如__ARCAEA__
变量：用两个大括号括起来，全大写的字符，例如{{ARCAEA}}。用法于和模板类似。
解析器函数：使用特定的函数（与一系列参数）计算值并表示，使用形式如{{#'''函数名''': 参数1|参数2...}}（请注意这里是英文的冒号:而不是中文的全角冒号）

状态开关

状态开关可以控制页面的显示方式和其他行为（受皮肤的影响，有些开关可能不起作用）。往往用于排除/加入特定的页面内容。

文字	描述
目录
`__NOTOC__`	隐藏当前页面的目录
`__FORCETOC__`	强制于默认位置（第一个章节标题的上方，不受`__NOTOC__`的设置）显示目录。对于在文章内容外展示目录的皮肤（比如Vector 2022）不起作用。
`__TOC__`	在该魔术字的位置插入目录（忽略`__NOTOC__`的设置）。多次使用时，在第一个魔术字处显示目录。同上，对部分皮肤不起作用。
编辑
`__NOEDITSECTION__`	隐藏章节标题旁的编辑链接。这个特别有用，当章节标题在模板中被创建时，普通的编辑链接将会把用户带到编辑模板代码界面，这与用户的直觉不符。在模板中使用它将扩充对模板嵌入页面的影响，以及任何包含在同一页面的其他模板。（Mediawiki原文如此）
`__NEWSECTIONLINK__`	在非讨论页顶端“编辑”标签右侧加入一个按钮，用于在页面结尾加入新的章节（比如讨论版）。
`__NONEWSECTIONLINK__`	移除讨论页顶端“编辑”右侧的加入新章节链接。
分类
`__NOGALLERY__`	用于分类页面（以Category为的页面前缀，下同）。不显示分类中所包含文件的缩略图，而以普通链接代替。
`__HIDDENCAT__`	用于分类页面。加入后此分类成为隐藏分类，将不会显示在上级分类其及成员页面的分类列表中。
`__EXPECTUNUSEDCATEGORY__`	在分类页面上使用，从Special:UnusedCategories中删除分类。
语言转换
`__NOCONTENTCONVERT__` `__NOCC__`	在语言有不同变体时（如中文简体和繁体），不对当前页面进行字词转换。比如只显示中文，而不是显示大陆简体、台湾繁体、新加坡简体和香港繁体。
`__NOTITLECONVERT__` `__NOTC__`	在语言有不同变体时（如中文简体和繁体），不对当前页面进行标题转换（其他内容照常转换）。
其他
~~`__START__`~~	无实际作用。曾用于指向不应被嵌入的注释之后开始的数据库消息。
~~`__END__`~~	明确标记条目的结尾，来防止MediaWiki移除文末的空格。
`__INDEX__`	允许搜索引擎检索本页。
`__NOINDEX__`	禁止搜索引擎检索本页（比如不可在搜索引擎列出指定页面）。（效果应是本魔术字之后的内容都不可检索）
`__STATICREDIRECT__`	用于一些重定向页面。当有人移动页面并勾选“更新所有指向原始标题的重定向”时，禁止MediaWiki更新本页的重定向。

变量

变量可以返回关于当前页面、wiki站点或日期的信息。变量的语法与模板类似。其中标记为“[高开销]”的变量会被软件记录，且在一个页面中可使用的总数会被限制。

如果某个模板名和变量名重复，软件会自动将其解释为变量。

比如现有一模板与魔术字都为BRCAEA，使用魔术字时只需要{{BRCAEA}}，而如果要调用模板，则需要加上前缀Template:：{{Template:BRCAEA}}。部分情况下，添加参数会迫使解析器调用模板；例如，写{{BRCAEA|616}}会导致嵌入Template:BRCAEA并传入相应参数（比如这里是616），而不是调用变量。

日期与时间

以下的变量返回当前的日期和UTC时间。

在MediaWiki与浏览器缓存的影响下，这些变量显示的往往是被缓存的值，而非当前的时间。

使用这些变量会使页面被缓存的时间变得更短，这可以通过 MagicWordFactory 设置。

日期和时间魔术字被格式化为相应的语种。自1.19版本开始，它们取决于页面内容语言。

（以上为Mediawiki原文）

翻译：

以下变量返回当前的日期/时间。

受缓存（服务器端）影响可能不准。

使用这些变量的页面缓存时间会变短。

日期和魔术字会翻译成相应语言（比如你站是中文）。

补充：前导0：指日期格式中补充位数的0，比如4月会补足为04,9日会补足为09。

变量	输出	描述
年
`{{CURRENTYEAR}}`	2024	年
月
`{{CURRENTMONTH}}`	11	月（补足前导0）
`{{CURRENTMONTH1}}`	11	月（不补足前导0）
`{{CURRENTMONTHNAME}}`	11月	月（本地语言中的月份名称）
`{{CURRENTMONTHNAMEGEN}}`	11月	月（本地语言中月份名称的属格形式）
`{{CURRENTMONTHABBREV}}`	11月	月（本地语言中月份名称的简称）
日
`{{CURRENTDAY}}`	15	日（无前导0）
`{{CURRENTDAY2}}`	15	日（补足前导0）
`{{CURRENTDOW}}`	5	星期（数字格式）
`{{CURRENTDAYNAME}}`	星期五	星期（文字形式）
时间
`{{CURRENTTIME}}`	19:19	时间（24小时制，格式为HH:mm）
`{{CURRENTHOUR}}`	19	时间（24小时制，有前导0）
其他
`{{CURRENTWEEK}}`	46	周数
`{{CURRENTTIMESTAMP}}`	20241115191946	YYYYMMDDHHmmss时间戳

CURRENTDATE不是魔术字，但很可能是一个模板。事实上在你站它并不是模板。

以下变量和上述变量作用相同（差了LOCAL和CURRENT），但使用的是网站服务器端配置的时间。

变量	输出	描述
年
`{{LOCALYEAR}}`	2024	年
月
`{{LOCALMONTH}}`	11	月（补足前导零）
`{{LOCALMONTH1}}`	11	月（不补足前导零）
`{{LOCALMONTHNAME}}`	11月	月（本地语言中的月份名称）
`{{LOCALMONTHNAMEGEN}}`	11月	月（本地语言中月份名称的属格形式）
`{{LOCALMONTHABBREV}}`	11月	月（本地语言中月份名称的简称）
日
`{{LOCALDAY}}`	16	日（无前导零）
`{{LOCALDAY2}}`	16	日（补足前导零）
`{{LOCALDOW}}`	6	星期（数字格式）
`{{LOCALDAYNAME}}`	星期六	星期
时间
`{{LOCALTIME}}`	03:19	时间（24小时制，格式为HH:mm）
`{{LOCALHOUR}}`	03	时间（24小时制，有前导零）
其他
`{{LOCALWEEK}}`	46	周数
`{{LOCALTIMESTAMP}}`	20241116031946	YYYYMMDDHHmmss时间戳

变量	输出	描述
站点
`{{SITENAME}}`	Arcaea中文维基	维基网站的名称
`{{SERVER}}`	https://arcwiki.mcd.blue	域名URL
`{{SERVERNAME}}`	arcwiki.mcd.blue	子域名和域名
`{{DIRMARK}}` `{{DIRECTIONMARK}}`	‎ ‎	输出这个wiki默认语言所使用的Unicode文本方向控制字符（从左到右书写的语言使用‎，反之使用‏），这在多方向文本中很有用。取决于页面语言。
`{{ARTICLEPATH}}`	/$1	相关文章路径
`{{SCRIPTPATH}}`		脚本相对路径
`{{STYLEPATH}}`	/skins	样式相对路径
`{{CURRENTVERSION}}`	1.39.5	此维基站点的MediaWiki版本。
`{{CONTENTLANGUAGE}}` `{{CONTENTLANG}}`	zh zh	默认界面语言
页面
`{{PAGEID}}`	4941	返回页面标识符（页面ID）。
`{{PAGELANGUAGE}}` `{{#language:{{PAGELANGUAGE}}}}`	zh 中文	返回当前页面的语言。此变量返回的语言代码可使用`{{#language:...}}`转换为语言名。
`<translate> <!--T:1--> Translated unit. Language: <tvar name=lang> {{TRANSLATIONLANGUAGE}} </tvar>. </translate>` `<translate> <!--T:2--> Untranslated unit. Language: <tvar name=lang> {{TRANSLATIONLANGUAGE}} </tvar>. </translate>`	已翻译单元。语言：zh-CN. Not translated unit. Language: en.	必须用于存在翻译的页面，在<translate>标签内部。返回当前翻译单元的语言代码。在翻译页面中，若此单元已被翻译，则返回此翻译的语言。否则，返回源语言。此变量返回的语言代码可使用`{{#language:...}}`转换为语言名。只应由翻译管理员使用。（此条在本站不能正常生效，但考虑到你站并没有这个需求……）
`{{PROTECTIONLEVEL:操作}}`		输出当前页面对于特定行为（比如edit，move）的保护级别（autoconfirm或sysop等）。若未保护则返回空字符串。
`{{PROTECTIONEXPIRY:操作}}`		根据给出的动作（如edit、move），返回当前页面的保护信息（例如：时间戳“20160418155030”，或“infinity”）如果未被保护，则会返回"infinity"。
`{{CASCADINGSOURCES}}`		[ 高开销]返回当前页面上的任意连锁保护操作来源。除非存在自我嵌入，否则页面将不会返回其各自标题。
查看当前页面的历史版本号（最近一次编辑版本或是选定的旧版本）
`{{REVISIONID}}`	54746	唯一修订ID。在预览中恒为空白，因此能用来显示仅限于预览时的错误消息。可能在守财奴模式(所有的WMF维基)中被停用，若不是在预览中改为回传`-`。（？）
`{{REVISIONDAY}}`	12	最近一次编辑的日期（无前导0）。
`{{REVISIONDAY2}}`	12	最近一次编辑的日期（有前导0）
`{{REVISIONMONTH}}`	08	最近一次编辑的月份（有前导0）。
`{{REVISIONMONTH1}}`	8	最近一次编辑的月份（没有前导0）。
`{{REVISIONYEAR}}`	2024	最近一次编辑的年份
`{{REVISIONTIMESTAMP}}`	20240812151303	最近一次编辑的时间戳。
`{{REVISIONUSER}}`	盐棋	编辑相关内容的用户或预览编辑内容的用户的用户名。
`{{REVISIONSIZE}}`	25773	当前查看的页面版本或预览的大小（维基文本）。（单位为字节）
影响页面内容
`{{DISPLAYTITLE: 标题}}` `{{DISPLAYTITLE: 标题\|noerror}}` `{{DISPLAYTITLE:标题\|noreplace}}`		设置当前页面的显示标题格式，这是页面标题通常显示的内容。除非$wgRestrictDisplayTitle设置为false，否则该值必须等同于默认标题：仅允许对标题的某些部分（而不是全部）进行大写更改，并允许用下划线替换空格。这可以通过$wgAllowDisplayTitle启用或禁用。可以使用第二个参数noerror或是noreplace，用来在当有多个标题在一个页面使用时，阻止产生错误消息，或是在页面中的前面已经指定了了一个`displaytitle`的情况下，使此`displaytitle`失效。（$wg是服务器端某个设置。）
`{{DEFAULTSORT:排序关键字}}` `{{DEFAULTSORTKEY:排序关键字}}` `{{DEFAULTCATEGORYSORT:排序关键字}}` `{{DEFAULTSORT:排序关键字\|noerror}}` `{{DEFAULTSORT: 排序关键字\|noreplace}}`		在为页面分类时使用，用来设置当前页面默认的分类排序关键字。例如当你将`{{DEFAULTSORT:Magic Word}}`}放到页面Help:魔术字的结尾，该页面在分类页面上的列表中将默认排到“M”项下。可以使用第二个参数noerror或是noreplace，用来在当有多个默认排序关键字在一个页面使用时，阻止产生错误消息，或是在页面中的前面已经指定了了一个defaultsort的情况下，使此defaultsort失效。

统计

这些变量返回的数字往往包含分隔符（根据本地语言参数设置而可能是逗号或空格）。可以通过“:R”来返回无分隔号的数字（例如{{NUMBEROFPAGES}} → 4,835和{{NUMBEROFPAGES:R}} → 4835）。

对于PAGESINCATEGORY等需要参数的变量则使用“|R”（例如{{PAGESINCATEGORY:Help}}和{{PAGESINCATEGORY:Help|R}}及{{PAGESINCATEGORY:Help|subcats}}和{{PAGESINCATEGORY:Help|subcats|R}}）。也适用于上述0。

返回数字的魔术字数字格式取决于内容语言的设定。

变量	输出	描述
`{{NUMBEROFPAGES}}`	4,835	wiki页面数量
`{{NUMBEROFARTICLES}}`	617	在内容命名空间中，作为条目的页面个数。
`{{NUMBEROFFILES}}`	1,655	上传文件的个数。
`{{NUMBEROFEDITS}}`	58,274	维基编辑的数量
~~`{{NUMBEROFVIEWS}}`~~	已移除	页面浏览次数。通常对使用缓存的wiki无效。已移除
`{{NUMBEROFUSERS}}`	4,881	注册用户数量
`{{NUMBEROFADMINS}}`	4	管理员（sysop）组用户数。
`{{NUMBEROFACTIVEUSERS}}`	67	活跃用户总数，基于Special:Statistics中使用的标准。
`{{PAGESINCATEGORY:分类名称}}` `{{PAGESINCAT: 分类名称}}`	0 0	[高开销] 指定分类中的页面总数（包括子类和文件）。（分类:帮助在此用于演示）
`{{PAGESINCATEGORY: 分类名称\|all}}` `{{PAGESINCATEGORY: 分类名称\|pages}}` `{{PAGESINCATEGORY: 分类名称\|subcats}}` `{{PAGESINCATEGORY: 分类名称\|files}}`		[高开销] 返回指定分类的：所有页面数所有非分类页和非文件页数所有子分类页数所有文件页数
`{{NUMBERINGROUP: 用户组}}` `{{NUMINGROUP: 用户组}}`	4 4	特定用户群组中的用户总数（这里管理员组为例）
`{{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。如果子页面不存在将会回传`{{PAGENAME}}`的值。
`{{SUBJECTPAGENAME}}` `{{ARTICLEPAGENAME}}`	Help:魔术字	获得该页面的完整页面名。对讨论页十分有用。
`{{TALKPAGENAME}}`	Help talk:魔术字	关联讨论页的完整页面名称

这些变量不受{{DISPLAYTITLE:xxxx}}影响，它们都会按原来的页面标题计算返回值。

{{BASEPAGENAME}}和{{SUBPAGENAME}}这两个魔术字只在启用了子页面模式的命名空间才生效。

以上魔术字可以接受一个参数，用于指定特定页面，来代替要处理的当前页面设定：

{{PAGENAME:Template:Main Page}}返回 Main Page。
如果页面标题包含存在“.”或“..”的任意部分，魔术字什么都不会返回。
页面标题如果包括特定字符，例如：单引号'、星号*会导致以上魔术字会有不正常的处理结果。

URL 编码后的页面名称

以下是在MediaWiki URL中的等价编码（就是空格替换为下划线，以及使用数字字符编码的一些HTML溢出字符）： {{FULLPAGENAMEE}}

{{PAGENAMEE}}

{{BASEPAGENAMEE}}

{{SUBPAGENAMEE}}

{{SUBJECTPAGENAMEE}}

{{ARTICLEPAGENAMEE}}

{{TALKPAGENAMEE}}

{{ROOTPAGENAMEE}}

命名空间

变量	输出	描述
`{{NAMESPACE}}`	Help	页面的命名空间的名称（除去主空间）
`{{NAMESPACENUMBER}}`	12	页面所在命名空间的ID
`{{SUBJECTSPACE}}` `{{ARTICLESPACE}}`	Help Help	相关联的内容命名空间的名称
`{{TALKSPACE}}`	Help talk	相关联的讨论命名空间的名称

以下是在MediaWiki URL中的的等价编码（空格替换为下划线，一些字符替换为百分号编码）： {{NAMESPACEE}}
{{SUBJECTSPACEE}}
{{ARTICLESPACEE}}
{{TALKSPACEE}}

这些可以是完整页面名参数，并将返回与那个页面相关的请求命名空间，而不是在当前页面中：

{{NAMESPACENUMBER:MediaWiki}} → 0
{{NAMESPACE:MediaWiki}} → （主）空间中的页面将返回空白
{{NAMESPACE:Template:Main Page}} → Template
{{SUBJECTSPACE:Template:Main Page}} → Template
{{ARTICLESPACE:Template:Main Page}} → Template
{{TALKSPACE:Template:Main Page}} → Template talk

参数必须不是一个命名空间名称：

{{SUBJECTSPACE:Help talk}}

其他

{{!}}插入一个管道符（|），但这里使用的是感叹号
{{=}}插入一个等于号

这两个魔术字在wiki上可能通过Template实现。（在本站是有的。）

解析器函数

见Help:解析器函数