编辑“十字军之王3百科:魔术字/系统变量”

{{wikinav}}
'''系统变量'''返回关于日期与时间、系统、页面的信息，其wikitext格式与模板非常相似。被标记为 <span style="background: #FED;">'''[高开销]'''</span> 的系统变量的使用将会被MediaWiki追踪，并且同一页面上能使用的高开销系统变量的数量是有限制的。

系统变量的结果有可能被缓存，此时使用“强制刷新页面”工具可能可以获得最新数据。

如果有模板的名字与系统变量名重复，那么MediaWiki将会以以下规则解释之：（以模板名和系统变量名均为FOO的情况为例）
# <code><nowiki>{{FOO}}</nowiki></code>将会解释为系统变量；
# <code><nowiki>{{Template:FOO}}</nowiki></code>将会解释为系统变量；
# <code><nowiki>{{FOO|变量1}}</nowiki></code>将会视情况而定：
##如果系统变量FOO不接受参数，那么<code><nowiki>{{FOO|变量1}}</nowiki></code>将会解释为模板；
##如果系统变量FOO接受参数，那么<code><nowiki>{{FOO|变量1}}</nowiki></code>将会解释为系统变量；


'''注意'''：一些系统变量能接受参数：
# 只能接受无命名参数；
# 第一个参数与函数名之间用冒号<code><nowiki>:</nowiki></code>分割而不是管道符<code><nowiki>|</nowiki></code>。

== 列表 ==
以下表格详细说明了王国风云3百科可用的系统变量。
{| class="wikitable" style="width: 100%;"
|-
! 系统变量
! 示例输出
! 描述
|-
! colspan="3" style="background-color: #DDDDDD;" class="heading" | 日期与时间<br /><span style="font-weight: normal;">（此类系统变量以用户在[[Special:参数设置#mw-prefsection-rendering|设置#显示]]的“时差”里设置的时区为准）</span><br /><span style="font-weight: normal;">（此类系统变量可以将变量名的<code><nowiki>CURRENT</nowiki></code>换成<code><nowiki>LOCAL</nowiki></code>以使用系统服务器时区<ref name="servertimezone" />）</span>
|-
| <code><nowiki>{{CURRENTYEAR}}</nowiki></code>
| {{CURRENTYEAR}}
| 当前年份
|-
| <code><nowiki>{{CURRENTMONTH}}</nowiki></code>
| {{CURRENTMONTH}}
| 当前月份（补足前导零<ref name="zero-padded" />）
|-
| <code><nowiki>{{CURRENTMONTH1}}</nowiki></code>
| {{CURRENTMONTH1}}
| 当前月份（不补足前导零<ref name="zero-padded" />）
|-
| <code><nowiki>{{CURRENTMONTHNAME}}</nowiki></code>
| {{CURRENTMONTHNAME}}
| 当前月份（以当前语言月份名为内容）
|-
| <code><nowiki>{{CURRENTMONTHNAMEGEN}}</nowiki></code>
| {{CURRENTMONTHNAMEGEN}}
| 当前月份（以当前语言月份名的所有格为内容）
|-
| <code><nowiki>{{CURRENTMONTHABBREV}}</nowiki></code>
| {{CURRENTMONTHABBREV}}
| 当前月份（以当前语言月份名的缩写为内容）
|-
| <code><nowiki>{{CURRENTDAY}}</nowiki></code>
| {{CURRENTDAY}}
| 输出今天是几号（不补足前导零<ref name="zero-padded" />）
|-
| <code><nowiki>{{CURRENTDAY2}}</nowiki></code>
| {{CURRENTDAY2}}
| 输出今天是几号（补足前导零<ref name="zero-padded" />）
|-
| <code><nowiki>{{CURRENTDOW}}</nowiki></code>
| {{CURRENTDOW}}
| 输出今天是星期几（不补足前导零<ref name="zero-padded" />），以0-6代指，0指星期天，6指星期六
|-
| <code><nowiki>{{CURRENTDAYNAME}}</nowiki></code>
| {{CURRENTDAYNAME}}
| 输出今天是星期几（以当前语言星期数名为内容）
|-
| <code><nowiki>{{CURRENTTIME}}</nowiki></code>
| {{CURRENTTIME}}
| 当前时间（24小时制）（输出格式为“小时数:分钟数”，全部补足前导零<ref name="zero-padded" />）
|-
| <code><nowiki>{{CURRENTHOUR}}</nowiki></code>
| {{CURRENTHOUR}}
| 当前小时数（24小时制，补足前导零<ref name="zero-padded" />）
|-
| <code><nowiki>{{CURRENTWEEK}}</nowiki></code>
| {{CURRENTWEEK}}
| 输出当前第几周
|-
| <code><nowiki>{{CURRENTTIMESTAMP}}</nowiki></code>
| {{CURRENTTIMESTAMP}}
| 时间戳<ref name="timestampformat" />
|-
! colspan="3" style="background-color: #DDDDDD;" class="heading" | 站点技术元数据
|-
| <code><nowiki>{{SITENAME}}</nowiki></code>
| {{SITENAME}}
| 站点名称（由[[mw:Special:MyLanguage/Manual:$wgSitename|$wgSitename]]设置）
|-
| <code><nowiki>{{SERVER}}</nowiki></code>
| {{SERVER}}
| 站点域名URL（由[[mw:Special:MyLanguage/Manual:$wgServer|$wgServer]]设置）
|-
| <code><nowiki>{{SERVERNAME}}</nowiki></code>
| {{SERVERNAME}}
| 输出子域名和域名（不再取决于[[mw:Special:MyLanguage/Manual:$wgServer|$wgServer]]）
|-
| <code><nowiki>{{DIRMARK}}</nowiki></code><br /><code><nowiki>{{DIRECTIONMARK}}</nowiki></code>
| {{DIRMARK}}<br />{{DIRECTIONMARK}}
| 输出站点默认语言所使用的Unicode文本方向控制字符（从左到右书写的语言使用<code><nowiki>&lrm;</nowiki></code>，反之使用<code><nowiki>&rlm;</nowiki></code>）
|-
| <code><nowiki>{{SCRIPTPATH}}</nowiki></code>
| {{SCRIPTPATH}}
| 脚本（index.php、load.php、api.php等）相对路径（由[[mw:Special:MyLanguage/Manual:$wgScriptPath|$wgScriptPath]]设置）
|-
| <code><nowiki>{{STYLEPATH}}</nowiki></code>
| {{STYLEPATH}}
| 皮肤样式相对路径（由[[mw:Special:MyLanguage/Manual:$wgStylePath|$wgStylePath]]设置）
|-
| <code><nowiki>{{CURRENTVERSION}}</nowiki></code>
| {{CURRENTVERSION}}
| 站点MediaWiki版本
|-
| <code><nowiki>{{CONTENTLANGUAGE}}</nowiki></code><br /><code><nowiki>{{CONTENTLANG}}</nowiki></code>
| {{CONTENTLANGUAGE}}<br />{{CONTENTLANG}}
| 站点默认界面语言（由[[mw:Special:MyLanguage/Manual:$wgLanguageCode|$wgLanguageCode]]设置）
|-
! colspan="3" style="background-color: #DDDDDD;" class="heading" | 页面技术元数据（参数说明<ref name="pagemetadatamagicword" />）
|-
| <code><nowiki>{{PAGEID}}</nowiki></code>
| {{PAGEID}}
| 当前页面ID
|-
| <code><nowiki>{{PROTECTIONLEVEL:</nowiki>'''操作<ref name="action" />'''<nowiki>}}</nowiki></code>
| {{PROTECTIONLEVEL:edit}}
| 输出当前页面对指定操作<ref name="action" />的保护级别<ref name="protectlevel" />。若未保护则返回空字符串
|-
| <code><nowiki>{{PROTECTIONEXPIRY:</nowiki>'''操作<ref name="action" />'''<nowiki>}}</nowiki></code>
| {{PROTECTIONEXPIRY:edit}}
| 输出当前页面对指定操作<ref name="action" />的保护时长，若时长无限则返回"infinity"，否则返回结束时刻的时间戳<ref name="timestampformat" />
|- style="background:#FED;"
| <code><nowiki>{{CASCADINGSOURCES}}</nowiki></code>
| {{CASCADINGSOURCES}}
| '''[高开销]''' 输出在本页面生效的级联保护的来源页面。除非页面自我嵌入（例如在一个在<code><nowiki><noinclude/></nowiki></code>说明文本内嵌入自己的模板）且设置了级联保护，否则不会输出页面自身的名字
|-
! colspan="3" style="background-color: #DDDDDD;" class="heading" | 页面最新版本<ref name="lastestversion" />信息
|-
| <code><nowiki>{{REVISIONID}}</nowiki></code>
| {{REVISIONID}}
| 页面最新版本<ref name="lastestversion" />的版本ID
|-
| <code><nowiki>{{REVISIONDAY}}</nowiki></code>
| {{REVISIONDAY}}
| 输出页面最新版本<ref name="lastestversion" />的修订日期是几号（不补足前导零<ref name="zero-padded" />）
|-
| <code><nowiki>{{REVISIONDAY2}}</nowiki></code>
| {{REVISIONDAY2}}
| 输出页面最新版本<ref name="lastestversion" />的修订日期是几号（补足前导零<ref name="zero-padded" />）
|-
| <code><nowiki>{{REVISIONMONTH}}</nowiki></code>
| {{REVISIONMONTH}}
| 页面最新版本<ref name="lastestversion" />的修订日期的月份（补足前导零<ref name="zero-padded" />）
|-
| <code><nowiki>{{REVISIONMONTH1}}</nowiki></code>
| {{REVISIONMONTH1}}
| 页面最新版本<ref name="lastestversion" />的修订日期的月份（不补足前导零<ref name="zero-padded" />）
|-
| <code><nowiki>{{REVISIONYEAR}}</nowiki></code>
| {{REVISIONYEAR}}
| 页面最新版本<ref name="lastestversion" />的修订日期的年份
|-
| <code><nowiki>{{REVISIONTIMESTAMP}}</nowiki></code>
| {{REVISIONTIMESTAMP}}
| 页面最新版本<ref name="lastestversion" />的修订日期的时间戳<ref name="timestampformat" />
|-
| <code><nowiki>{{REVISIONUSER}}</nowiki></code>
| {{REVISIONUSER}}
| 页面最新版本<ref name="lastestversion" />的编辑者
|-
| <code><nowiki>{{REVISIONSIZE}}</nowiki></code>
| {{REVISIONSIZE}}
| 页面最新版本<ref name="lastestversion" />的wikitext源码的大小（单位：byte）
|-
! colspan="3" style="background-color: #DDDDDD;" class="heading" | 站点数据统计（分隔符说明<ref name="delimiter" />）
|-
| <code><nowiki>{{NUMBEROFPAGES}}</nowiki></code>
| {{NUMBEROFPAGES}}
| 站点页面个数
|-
| <code><nowiki>{{NUMBEROFARTICLES}}</nowiki></code>
| {{NUMBEROFARTICLES}}
| [[mw:Manual:Using_custom_namespaces/zh#content-ns|内容名字空间]]下的页面个数
|-
| <code><nowiki>{{NUMBEROFFILES}}</nowiki></code>
| {{NUMBEROFFILES}}
| 已上传的文件个数（不包含共享站文件数）
|-
| <code><nowiki>{{NUMBEROFEDITS}}</nowiki></code>
| {{NUMBEROFEDITS}}
| 站点编辑次数
|-
| <code><nowiki>{{NUMBEROFUSERS}}</nowiki></code>
| {{NUMBEROFUSERS}}
| 站点用户数量
|-
| <code><nowiki>{{NUMBEROFADMINS}}</nowiki></code>
| {{NUMBEROFADMINS}}
| 管理员（sysop）数量
|-
| <code><nowiki>{{NUMBEROFACTIVEUSERS}}</nowiki></code>
| {{NUMBEROFACTIVEUSERS}}
| 活跃用户数量，活跃用户的标准与[[Special:活跃用户]]的一样
|- style="background:#FED;"
| <code><nowiki>{{PAGESINCATEGORY:分类名称}}</nowiki></code><br /><code><nowiki>{{PAGESINCAT:分类名称}}</nowiki></code>
| {{PAGESINCATEGORY:帮助}}<br />{{PAGESINCAT:帮助}}
| '''[高开销]''' 输出指定分类中的页面总数（包括子类和文件）（以[[:分类:帮助]]为示例）
|- style="background:#FED;"
|
# <code><nowiki>{{PAGESINCATEGORY:分类名称|all}}</nowiki></code>
# <code><nowiki>{{PAGESINCATEGORY:分类名称|pages}}</nowiki></code>
# <code><nowiki>{{PAGESINCATEGORY:分类名称|subcats}}</nowiki></code>
# <code><nowiki>{{PAGESINCATEGORY:分类名称|files}}</nowiki></code>
|
# {{PAGESINCATEGORY:帮助|all}}
# {{PAGESINCATEGORY:帮助|pages}}
# {{PAGESINCATEGORY:帮助|subcats}}
# {{PAGESINCATEGORY:帮助|files}}
| '''[高开销]''' 输出指定分类的：
# 所有页面数
# 所有非分类页和非文件页的页面数
# 所有子分类页面数
# 所有文件页面数
（以[[:分类:帮助]]为示例）
|-
| <code><nowiki>{{NUMBERINGROUP:用户组}}</nowiki></code><br/><code><nowiki>{{NUMINGROUP:用户组}}</nowiki></code>
| {{NUMBERINGROUP:bureaucrat}} (<code><nowiki>{{NUMBERINGROUP:bureaucrat}}</nowiki></code>)<br />{{NUMINGROUP:patroller}}（<code><nowiki>{{NUMINGROUP:patroller}}</nowiki></code>）
| 特定用户组中的用户总数
|- style="background:#FED;"
| <code><nowiki>{{PAGESINNS:名字空间编号}}</nowiki></code><br /><code><nowiki>{{PAGESINNAMESPACE:名字空间编号}}</nowiki></code>
| ''未启用''
| '''[高开销]''' 输出指定[[project:名字空间|名字空间]]中的页面总数。<br /><code><nowiki>{{PAGESINNS:0}}</nowiki></code>与<code><nowiki>{{NUMBEROFARTICLES}}</nowiki></code>不同之处在于前者包含重定向页面和消除歧义页面，不包含其他内容名字空间页面。<br />默认禁用，可以通过[[mw:Special:MyLanguage/Manual:$wgAllowSlowParserFunctions|$wgAllowSlowParserFunctions]]设置启用。
|-
! colspan="3" style="background-color: #DDDDDD;" class="heading" | 页面名称（参数说明<ref name="titlemagicword" />）（URL编码说明<ref name="urlencode" />）<br />警告：当前页面标题如果包括特定字符，会导致本部分系统变量会有不正常的处理结果<ref name="titlemagicwordwarning" />
|-
| <code><nowiki>{{FULLPAGENAME}}</nowiki></code>
| {{FULLPAGENAME}}
| 包含名字空间的完整页面标题
|-
| <code><nowiki>{{PAGENAME}}</nowiki></code>
| {{PAGENAME}}
| 不包含名字空间的完整页面标题
|-
| <code><nowiki>{{BASEPAGENAME}}</nowiki></code>
| {{BASEPAGENAME}}
| 不包含名字空间和当前子页面标题的的页面标题<ref name="titleparts" />（例如："Help:Title/foo/bar"返回"Title/foo"）
|-
| <code><nowiki>{{SUBPAGENAME}}</nowiki></code>
| {{SUBPAGENAME}}
| 子页面标题<ref name="titleparts" />（例如 "Help:Title/foo/bar"中的"bar"）
|-
| <code><nowiki>{{SUBJECTPAGENAME}}</nowiki></code><br /><code><nowiki>{{ARTICLEPAGENAME}}</nowiki></code>
| {{SUBJECTPAGENAME}}<br />{{ARTICLEPAGENAME}}
| 返回该页面的本体的完整页面名。即使是在讨论页中也会返回本体页面名（例如在“Talk:提问求助区”页面中返回“提问求助区”）
|-
| <code><nowiki>{{TALKPAGENAME}}</nowiki></code>
| {{TALKPAGENAME}}
| 返回该页面的讨论页的完整页面名（例如在“提问求助区”页面中返回“Talk:提问求助区”）
|-
| <code><nowiki>{{ROOTPAGENAME}}</nowiki></code>
| {{ROOTPAGENAME}}
| 返回该页面的根页面的不含名字空间的页面名<ref name="titleparts" />（例如："Help:Title/foo/bar"返回"Title"）
|-
! colspan="3" style="background-color: #DDDDDD;" class="heading" | 名字空间<ref name="namespacemagicword" />
|-
| <code><nowiki>{{NAMESPACE}}</nowiki></code>
| {{NAMESPACE}}
| 当前页面名字空间名称
|-
| <code><nowiki>{{NAMESPACENUMBER}}</nowiki></code>
| {{NAMESPACENUMBER}}
| 当前页面名字空间ID
|-
| <code><nowiki>{{SUBJECTSPACE}}</nowiki></code><br /><code><nowiki>{{ARTICLESPACE}}</nowiki></code>
| {{SUBJECTSPACE}}<br />{{ARTICLESPACE}}
| 返回该页面的本体的名字空间名称
|-
| <code><nowiki>{{TALKSPACE}}</nowiki></code>
| {{TALKSPACE}}
| 返回该页面的讨论页的名字空间名称
|-
! colspan="3" style="background-color: #DDDDDD;" class="heading" |其他
|-
| <code><nowiki>{{!}}</nowiki></code>
| style="text-align: center;" | <nowiki>|</nowiki>
| 返回一个管道符，它可以在模板嵌套表格或表格嵌套模板之时在被嵌套的表格/模板中代替管道符以免嵌套的模板/表格将其解析导致语法错乱，例如：<pre>{|
|-
| {{colorblock{{!}}red}}
|}</pre>
更详细的信息请参阅[[mw:Template:!#template-documentation|更多]]
|}

== 注释 ==
<references>
<ref name="zero-padded">前导零指的是为了将数字补足到指定长度而在开头补上若干个零，例如8月的前导零补足是08月。</ref>
<ref name="servertimezone">系统服务器时区指的是服务器所在地区的时区或者[[mw:Special:MyLanguage/Manual:$wgLocaltimezone|$wgLocaltimezone]]设置的时区</ref>
<ref name="timestampformat">此时间戳以YYYYMMDDHHmmss为格式</ref>
<ref name="pagemetadatamagicword">本部分系统变量接受一个额外参数，指定特定页面来代替当前页面的元信息：
* <code><nowiki>{{PROTECTIONLEVEL: move | Mainpage}}</nowiki></code> → {{PROTECTIONLEVEL: move | Mainpage}}
'''但请注意：如果额外参数指定的页面不是当前页面时则属于 <span style="background: #FED;">[高开销]</span> 系统变量！'''</ref>
<ref name="action">动作指的是对页面的操作，包括edit（编辑）、move（移动）、delete（删除）、create（创建）等</ref>
<ref name="protectlevel">保护级别指的是对特定操作的可操作用户组的限制，""（空）代表没有限制，"autoconfirm"（半保护）代表只有自动确认用户才可执行操作，"patrolleredit"（仅允许管理员和巡查姬）代表只有巡查姬和管理员才可执行操作，"sysop"代表只有管理员才可执行操作</ref>
<ref name="lastestversion">页面最新版本指的是该页面的最后一个修订版本（'''页面正常访问时显示'''的版本或'''正在预览'''的版本）</ref>
<ref name="delimiter">本部分系统变量返回的数字往往包含分隔符（根据页面使用语言可能是逗号或空格），将参数1设为R可以得到无分隔号的数字（例如<code><nowiki>{{NUMBEROFPAGES}}</nowiki></code> → {{NUMBEROFPAGES}}和<code><nowiki>{{NUMBEROFPAGES:R}}</nowiki></code> → {{NUMBEROFPAGES:R}}）。</ref>
<ref name="titlemagicword">本部分系统变量接受一个参数1，用于指定特定页面来代替当前页面的信息：
* <code><nowiki>{{PAGENAME:Talk:提问求助区}}</nowiki></code> → {{PAGENAME:Talk:提问求助区}}</ref>
<ref name="urlencode">本部分系统变量可以通过在系统变量名后加一个<code><nowiki>E</nowiki></code>（例如<code><nowiki>{{PAGENAMEE:...}}</nowiki></code>）来获得经过'''MediaWiki URL编码'''后的标题，这样的标题适合用于'''指向特定页面的链接'''中。<br />注意<code><nowiki>{{PAGENAME:...}}</nowiki></code>、<code><nowiki>{{PAGENAMEE:...}}</nowiki></code>和<code><nowiki>{{urlencode:...}}</nowiki></code>有不同的实现方式，'''只有<code><nowiki>{{PAGENAMEE:...}}</nowiki></code>才能输出符合MediaWiki URL编码规则的标题'''，更细节的信息请参阅[[mw:Special:MyLanguage/Manual:PAGENAMEE encoding|Manual:PAGENAMEE encoding]]。</ref>
<ref name="titlemagicwordwarning">'''警告'''：当前页面标题如果包含特定字符——例如单引号<code><nowiki>'</nowiki></code>、星号<code><nowiki>*</nowiki></code>——会导致本部分系统变量有不正常的结果。一种简单的修复方法是使用<code><nowiki>{{#titleparts:}}</nowiki></code>解析器函数来处理标题。<br />例如，如果页面标题是<code><nowiki>L'Aquila</nowiki></code>，下面的结果将会是“Numeric char encoding”：
<pre>
{{#switch:{{PAGENAME}}
| L'Aquila = No translation
| L = Not OK
| L&apos;Aquila = Entity escaping
| L&#39;Aquila = Numeric char encoding
}}
</pre></ref>
<ref name="titleparts">此类系统变量仅能实现基础功能，如需要更多匹配请使用<code>[[{{NAMESPACE}}:{{BASEPAGENAME}}/解析器函数|<nowiki>{{#titlepars:}}</nowiki>]]</code></ref>
<ref name="namespacemagicword"><ol><li>本部分系统变量，除<code><nowiki>{{NAMESPACENUMBER}}</nowiki></code>外，可以通过在系统变量名后加一个<code><nowiki>E</nowiki></code>（例如<code><nowiki>{{NAMESPACEE}}</nowiki></code>）来获得经过'''MediaWiki URL编码'''后的分类。</li><li>本部分系统变量接受一个参数1，用于指定特定页面的名字空间来代替当前页面的名字空间：
* <code><nowiki>{{NAMESPACE:MediaWiki}}</nowiki></code> → （空）
* <code><nowiki>{{NAMESPACE:Template:Main Page}}</nowiki></code> → {{NAMESPACE:Template:Main Page}}
* <code><nowiki>{{TALKSPACE:Template:Main Page}}</nowiki></code> → {{TALKSPACE:Template:Main Page}}
参数必须是一个页面名，即使填入的是一个名字空间名称，MediaWiki也会将其作为页面名处理：
* <code><nowiki>{{SUBJECTSPACE:Help talk}}</nowiki></code> → （空）</ol>
</ref>
</references>

[[Category:百科]]