帮助:魔术字/系统变量

这个页面“Help:魔术字/系统变量”是萌娘百科的帮助文档

• 本文用于介绍萌娘百科中一些特定功能的操作方法；
• 本文仅是一篇论述，不属于方针或指引。如果本指南与相关方针或指引发生冲突或存在不一致的情况，请以方针或指引的条文为准。

• 状态开关
• 系统变量
• 解析器函数

系统变量返回关于日期与时间、系统、页面的信息，其wikitext格式与模板非常相似，但是只有一部分系统变量接受参数。被标记为 [高开销] 的系统变量的使用将会被MediaWiki追踪，并且同一页面上能使用的高开销系统变量的数量是有限制的。

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

如果有模板的名字与系统变量名重复，那么MediaWiki将会以以下规则解释之：（以模板名和系统变量名均为FOO的情况为例）

1. {{FOO}}将会解释为系统变量；
2. {{Template:FOO}}将会解释为模板；
3. {{FOO|变量1}}将会视情况而定：
   1. 如果系统变量FOO不接受参数，那么{{FOO|变量1}}将会解释为模板；
   2. 如果系统变量FOO接受参数，那么{{FOO|变量1}}将会解释为系统变量；

注意：部分系统变量能接受参数：

1. 只能接受无命名参数；
2. 第一个参数与函数名之间用冒号:分割而不是管道符|。

列表

以下表格详细说明了萌百可用的系统变量。请仔细阅读注释，注释里包含许多相当有用的说明。

系统变量	示例输出	描述
日期与时间 （此类系统变量以系统服务器时区为准）
{{LOCALYEAR}} {{CURRENTYEAR}}	2024 2024	当前年份 （日期与时间类系统变量可以将变量名的LOCAL换成CURRENT以使用UTC时区，下同）
{{LOCALMONTH}} {{CURRENTMONTH}}	12 12	当前月份（补足前导零）
{{LOCALMONTH1}} {{CURRENTMONTH1}}	12 12	当前月份（不补足前导零）
{{LOCALMONTHNAME}} {{CURRENTMONTHNAME}}	12月 12月	当前月份（以当前语言月份名为内容）
{{LOCALMONTHNAMEGEN}} {{CURRENTMONTHNAMEGEN}}	12月 12月	当前月份（以当前语言月份名的所有格为内容）
{{LOCALMONTHABBREV}} {{CURRENTMONTHABBREV}}	12月 12月	当前月份（以当前语言月份名的缩写为内容）
{{LOCALDAY}} {{CURRENTDAY}}	20 19	输出今天是几号（不补足前导零）
{{LOCALDAY2}} {{CURRENTDAY2}}	20 19	输出今天是几号（补足前导零）
{{LOCALDOW}} {{CURRENTDOW}}	5 4	输出今天是星期几（不补足前导零），以0-6代指，0指星期天，6指星期六
{{LOCALDAYNAME}} {{CURRENTDAYNAME}}	星期五 星期四	输出今天是星期几（以当前语言星期数名为内容）
{{LOCALTIME}} {{CURRENTTIME}}	02:54 18:54	当前时间（24小时制）（输出格式为“小时数:分钟数”，全部补足前导零）
{{LOCALHOUR}} {{CURRENTHOUR}}	02 18	当前小时数（24小时制，补足前导零）
{{LOCALWEEK}} {{CURRENTWEEK}}	51 51	输出当前第几周
{{LOCALTIMESTAMP}} {{CURRENTTIMESTAMP}}	20241220025439 20241219185439	时间戳
站点技术元数据
{{SITENAME}}	萌娘百科	站点名称（由$wgSitename设置）
{{SERVER}}	https://moegirl.icu	站点域名URL（由$wgServer设置）
{{SERVERNAME}}	moegirl.icu	输出子域名和域名（不再取决于$wgServer）
{{DIRMARK}} {{DIRECTIONMARK}}	‎ ‎	输出站点默认语言所使用的Unicode文本方向控制字符（从左到右书写的语言使用‎，反之使用‏）
{{SCRIPTPATH}}		脚本（index.php、load.php、api.php等）相对路径（由$wgScriptPath设置）
{{STYLEPATH}}	/skins	皮肤样式相对路径（由$wgStylePath设置）
{{CURRENTVERSION}}	1.43.0-alpha （b8f4294）	站点MediaWiki版本
{{CONTENTLANGUAGE}} {{CONTENTLANG}}	zh zh	站点默认界面语言（由$wgLanguageCode设置）
页面技术元数据（以本页面为例）
说明： 本部分系统变量接受一个额外参数，指定特定页面来代替当前页面的元信息： {{PROTECTIONLEVEL: move | Mainpage}} → sysop {{REVISIONID:Mainpage}} → 6503389 但请注意：如果额外参数指定的页面不是当前页面时则属于 [高开销] 系统变量！
{{PAGELANGUAGE}} {{#language:{{PAGELANGUAGE}}}}	zh 中文	返回当前页面的语言。此变量返回的语言代码可使用{{#language:...}}转换为语言名。
{{PAGEID}}	204749	当前页面ID
{{PROTECTIONLEVEL:操作}}		输出当前页面对指定操作的保护级别。若未保护则返回空字符串
{{PROTECTIONEXPIRY:操作}}	infinity	输出当前页面对指定操作的保护时长，若时长无限则返回"infinity"，否则返回结束时刻的时间戳
{{CASCADINGSOURCES}}		[高开销] 输出在本页面生效的级联保护的来源页面。除非页面自我嵌入（例如在一个在<noinclude/>说明文本内嵌入自己的模板）且设置了级联保护，否则不会输出页面自身的名字
页面最新版本信息（以本页面为例）
说明： 本部分系统变量接受一个额外参数，指定特定页面来代替当前页面的元信息： {{PROTECTIONLEVEL: move | Mainpage}} → sysop {{REVISIONID:Mainpage}} → 6503389 但请注意：如果额外参数指定的页面不是当前页面时则属于 [高开销] 系统变量！
{{REVISIONID}}	-	页面最新版本的版本ID
{{REVISIONDAY}}	28	输出页面最新版本的修订日期是几号（不补足前导零）
{{REVISIONDAY2}}	28	输出页面最新版本的修订日期是几号（补足前导零）
{{REVISIONMONTH}}	09	页面最新版本的修订日期的月份（补足前导零）
{{REVISIONMONTH1}}	9	页面最新版本的修订日期的月份（不补足前导零）
{{REVISIONYEAR}}	2023	页面最新版本的修订日期的年份
{{REVISIONTIMESTAMP}}	20230928010804	页面最新版本的修订日期的时间戳
{{REVISIONUSER}}	星海子	页面最新版本的编辑者
{{REVISIONSIZE}}	21056	页面最新版本的wikitext源码的大小（单位：byte）
站点数据统计
说明： 本部分系统变量返回的数字往往包含分隔符（根据页面使用语言可能是逗号或空格），将参数1设为R可以得到无分隔号的数字（例如{{NUMBEROFPAGES}} → 319,431和{{NUMBEROFPAGES:R}} → 319431）。
{{NUMBEROFPAGES}}	319,431	站点页面个数
{{NUMBEROFARTICLES}}	132,208	内容名字空间下的页面个数
{{NUMBEROFFILES}}	0	已上传的文件个数（不包含共享站文件数）
{{NUMBEROFEDITS}}	5,640,388	站点编辑次数
{{NUMBEROFUSERS}}	72,541	站点用户数量
{{NUMBEROFADMINS}}	2	管理员（sysop）数量
{{NUMBEROFACTIVEUSERS}}	1,153	活跃用户数量，活跃用户的标准与Special:活跃用户的一样
{{PAGESINCATEGORY:分类名称}} {{PAGESINCAT:分类名称}}	123 123	[高开销] 输出指定分类中的页面总数（包括子类和文件）（以分类:帮助为示例）
{{PAGESINCATEGORY:分类名称|all}} {{PAGESINCATEGORY:分类名称|pages}} {{PAGESINCATEGORY:分类名称|subcats}} {{PAGESINCATEGORY:分类名称|files}}	123 120 3 0	[高开销] 输出指定分类的： 所有页面数 所有非分类页和非文件页的页面数 所有子分类页面数 所有文件页面数 （以分类:帮助为示例）
{{NUMBERINGROUP:用户组}} {{NUMINGROUP:用户组}}	1 ({{NUMBERINGROUP:bureaucrat}}) 0（{{NUMINGROUP:patroller}}）	特定用户组中的用户总数
{{PAGESINNS:名字空间编号}} {{PAGESINNAMESPACE:名字空间编号}}	未启用	[高开销] 输出指定名字空间中的页面总数。 {{PAGESINNS:0}}与{{NUMBEROFARTICLES}}不同之处在于前者包含重定向页面和消除歧义页面，不包含其他内容名字空间页面。 默认禁用，可以通过$wgAllowSlowParserFunctions设置启用。
页面名称（以本页面为例）
说明： 本部分系统变量接受一个参数1，用于指定特定页面来代替当前页面的信息： {{PAGENAME:Talk:提问求助区}} → 提问求助区 本部分系统变量可以通过在系统变量名后加一个E（例如{{PAGENAMEE:...}}）来获得经过MediaWiki URL编码后的标题，这样的标题适合用于指向特定页面的链接中。 注意{{PAGENAME:...}}、{{PAGENAMEE:...}}和{{urlencode:...}}有不同的实现方式，只有{{PAGENAMEE:...}}才能输出符合MediaWiki URL编码规则的标题，更细节的信息请参阅MediaWiki官网的Manual:PAGENAMEE encoding。 警告： 部分系统变量会将页面标题的特定字符——例如单引号'、星号*——转义。 例如，如果页面标题是L'Aquila，{{subst:PAGENAME}}保存后将会是L&#39;Aquila。 若要避免转义，一种简单的方法是使用{{#titleparts:}}解析器函数来处理标题。
{{FULLPAGENAME}}	Help:魔术字/系统变量	包含名字空间的完整页面标题
{{PAGENAME}}	魔术字/系统变量	不包含名字空间的完整页面标题
{{BASEPAGENAME}}	魔术字	不包含名字空间和当前子页面标题的页面标题（例如："Help:Title/foo/bar"返回"Title/foo"）
{{SUBPAGENAME}}	系统变量	子页面标题（例如 "Help:Title/foo/bar"中的"bar"）
{{SUBJECTPAGENAME}} {{ARTICLEPAGENAME}}	Help:魔术字/系统变量 Help:魔术字/系统变量	返回该页面的本体的完整页面名。即使是在讨论页中也会返回本体页面名（例如在“Talk:提问求助区”页面中返回“提问求助区”）
{{TALKPAGENAME}}	Help talk:魔术字/系统变量	返回该页面的讨论页的完整页面名（例如在“提问求助区”页面中返回“Talk:提问求助区”）
{{ROOTPAGENAME}}	魔术字	返回该页面的根页面的不含名字空间的页面名（例如："Help:Title/foo/bar"返回"Title"）
名字空间（以本页面为例）
说明： 本部分系统变量，除{{NAMESPACENUMBER}}外，可以通过在系统变量名后加一个E（例如{{NAMESPACEE}}）来获得经过MediaWiki URL编码后的分类。 本部分系统变量接受一个参数1，用于指定特定页面的名字空间来代替当前页面的名字空间（若不设置则默认使用当前页面的标题）： {{NAMESPACE:MediaWiki}} → （空） {{NAMESPACE:Template:Main Page}} → Template {{TALKSPACE:Template:Main Page}} → Template talk 如果参数1不为空，则该参数名只会被MediaWiki理解成一个页面名，即使填入的是一个名字空间名称，MediaWiki也会将其作为页面名处理： {{SUBJECTSPACE:Help talk}} → （空）
{{NAMESPACE}}	Help	当前页面名字空间名称
{{NAMESPACENUMBER}}	12	当前页面名字空间ID
{{SUBJECTSPACE}} {{ARTICLESPACE}}	Help Help	返回该页面的本体的名字空间名称
{{TALKSPACE}}	Help talk	返回该页面的讨论页的名字空间名称
其他
{{!}}	|	返回一个管道符，它可以在模板嵌套表格或表格嵌套模板之时在被嵌套的表格/模板中代替管道符以免嵌套的模板/表格将其解析导致语法错乱，例如： {| |- | {{colorblock{{!}}red}} |} 更详细的信息请参阅MediaWiki网站的文档。