MCBBS Wiki欢迎您共同参与编辑！在参与编辑之前请先阅读Wiki方针。

如果在编辑的过程中遇到了什么问题，可以去讨论板提问。

为了您能够无阻碍地参与编辑 未验证/绑定过邮箱的用户，请尽快绑定/验证。

MCBBS Wiki GitHub群组已上线！

您可以在回声洞中发表吐槽！

服务器状态监控。点击进入

本站由MCBBS用户自行搭建，与MCBBS及东银河系漫游指南（北京）科技有限公司没有从属关系。点此了解 MCBBS Wiki 不是什么>>

帮助:魔术字/系统变量

来自MCBBS Wiki
< 帮助:魔术字
Sheep-realms（留言 | 贡献）2020年7月17日 (五) 15:57的版本 （创建页面，内容为“{{帮助文档难度/困难}} '''系统变量'''返回关于日期与时间、系统、页面的信息，其维基文本格式与模板非常相似，但是只有一…”）
(差异) ←上一版本 | 最后版本 (差异) | 下一版本→ (差异)
跳到导航 跳到搜索
这篇帮助文档的难度为：困难
这篇帮助文档比较复杂，适合资深编辑者阅读。阅读这篇帮助文档前，您需要熟练掌握Wiki知识，对复杂语法有一定的了解。

系统变量返回关于日期与时间、系统、页面的信息，其维基文本格式与模板非常相似，但是只有一部分系统变量接受参数。

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

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

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


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

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

此页面拷贝自萌娘百科-Help:魔术字/系统变量，已经过本土化修改。

列表

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

日期与时间

系统变量 示例输出 描述
日期与时间
（此类系统变量以系统服务器时区[1]为准）
{{LOCALYEAR}}
{{CURRENTYEAR}} 		2024
2024 		当前年份
（日期与时间类系统变量可以将变量名的LOCAL换成CURRENT以使用UTC时区，下同）
{{LOCALMONTH}}
{{CURRENTMONTH}} 		06
06 		当前月份（补足前导零[2]）
{{LOCALMONTH1}}
{{CURRENTMONTH1}} 		6
6 		当前月份（不补足前导零[2]）
{{LOCALMONTHNAME}}
{{CURRENTMONTHNAME}} 		6月
6月 		当前月份（以当前语言月份名为内容）
{{LOCALMONTHNAMEGEN}}
{{CURRENTMONTHNAMEGEN}} 		6月
6月 		当前月份（以当前语言月份名的所有格为内容）
{{LOCALMONTHABBREV}}
{{CURRENTMONTHABBREV}} 		6月
6月 		当前月份（以当前语言月份名的缩写为内容）
{{LOCALDAY}}
{{CURRENTDAY}} 		1
1 		输出今天是几号（不补足前导零[2]）
{{LOCALDAY2}}
{{CURRENTDAY2}} 		01
01 		输出今天是几号（补足前导零[2]）
{{LOCALDOW}}
{{CURRENTDOW}} 		6
6 		输出今天是星期几（不补足前导零[2]），以0-6代指，0指星期天，6指星期六
{{LOCALDAYNAME}}
{{CURRENTDAYNAME}} 		星期六
星期六 		输出今天是星期几（以当前语言星期数名为内容）
{{LOCALTIME}}
{{CURRENTTIME}} 		17:36
09:36 		当前时间（24小时制）（输出格式为“小时数:分钟数”，全部补足前导零[2]）
{{LOCALHOUR}}
{{CURRENTHOUR}} 		17
09 		当前小时数（24小时制，补足前导零[2]）
{{LOCALWEEK}}
{{CURRENTWEEK}} 		22
22 		输出当前第几周
{{LOCALTIMESTAMP}}
{{CURRENTTIMESTAMP}} 		20240601173649
20240601093649 		时间戳[3]

站点技术元数据

系统变量 示例输出 描述
站点技术元数据
{{SITENAME}} MCBBS Wiki 站点名称（由$wgSitename设置）
{{SERVER}} https://mcbbs.wiki 站点域名URL（由$wgServer设置）
{{SERVERNAME}} mcbbs.wiki 输出子域名和域名（不再取决于$wgServer）
{{DIRMARK}}
{{DIRECTIONMARK}} 		‎
‎ 		输出站点默认语言所使用的Unicode文本方向控制字符（从左到右书写的语言使用&lrm;，反之使用&rlm;）
{{SCRIPTPATH}} 脚本（index.php、load.php、api.php等）相对路径（由$wgScriptPath设置）
{{STYLEPATH}} /skins 皮肤样式相对路径（由$wgStylePath设置）
{{CURRENTVERSION}} 1.40.3 站点MediaWiki版本
{{CONTENTLANGUAGE}}
{{CONTENTLANG}} 		zh-cn
zh-cn 		站点默认界面语言（由$wgLanguageCode设置）

页面技术元数据

系统变量 示例输出 描述
页面技术元数据（以本页面为例）（参数说明[4]）
{{PAGELANGUAGE}}
{{#language:{{PAGELANGUAGE}}}} 		zh-cn
中文（中国大陆） 		返回当前页面的语言。此变量返回的语言代码可使用{{#language:...}}转换为语言名。
{{PAGEID}} 2044 当前页面ID
{{PROTECTIONLEVEL:操作[5]}} 输出当前页面对指定操作[5]的保护级别[6]。若未保护则返回空字符串
{{PROTECTIONEXPIRY:操作[5]}} infinity 输出当前页面对指定操作[5]的保护时长，若时长无限则返回"infinity"，否则返回结束时刻的时间戳[3]

页面最新版本

系统变量 示例输出 描述
页面最新版本[7]信息（以本页面为例）（参数说明[4]）
{{REVISIONID}} 14331 页面最新版本[7]的版本ID
{{REVISIONDAY}} 17 输出页面最新版本[7]的修订日期是几号（不补足前导零[2]）
{{REVISIONDAY2}} 17 输出页面最新版本[7]的修订日期是几号（补足前导零[2]）
{{REVISIONMONTH}} 07 页面最新版本[7]的修订日期的月份（补足前导零[2]）
{{REVISIONMONTH1}} 7 页面最新版本[7]的修订日期的月份（不补足前导零[2]）
{{REVISIONYEAR}} 2020 页面最新版本[7]的修订日期的年份
{{REVISIONTIMESTAMP}} 20200717155752 页面最新版本[7]的修订日期的时间戳[3]
{{REVISIONUSER}} Sheep-realms 页面最新版本[7]的编辑者
{{REVISIONSIZE}} 20076 页面最新版本[7]的wikitext源码的大小（单位：byte）

站点数据统计

系统变量 示例输出 描述
站点数据统计（分隔符说明[8]）
{{NUMBEROFPAGES}} 5,604 站点页面个数
{{NUMBEROFARTICLES}} 829 内容名字空间下的页面个数
{{NUMBEROFFILES}} 1,121 已上传的文件个数（不包含共享站文件数）
{{NUMBEROFEDITS}} 54,348 站点编辑次数
{{NUMBEROFUSERS}} 1,611 站点用户数量
{{NUMBEROFADMINS}} 10 管理员（sysop）数量
{{NUMBERINGROUP:用户组}}
{{NUMINGROUP:用户组}} 		4 ({{NUMBERINGROUP:bureaucrat}})
4（{{NUMINGROUP:patroller}}） 		特定用户组中的用户总数

页面名称

系统变量 示例输出 描述
页面名称（以本页面为例）（参数说明[9]）（URL编码说明[10]）
警告：当前页面标题如果包括特定字符，会导致本部分系统变量会有不正常的处理结果[11]
说明：
  1. 本部分系统变量均可选设置一个参数以获取其他页面的信息，格式为：{{系统变量:页面标题}}，若不设置则默认使用当前页面的标题。
{{FULLPAGENAME}} 帮助:魔术字/系统变量 包含名字空间的完整页面标题
{{PAGENAME}} 魔术字/系统变量 不包含名字空间的完整页面标题
{{BASEPAGENAME}} 魔术字 不包含名字空间和当前子页面标题的的页面标题[12]（例如："帮助:主页面/子页面/二级子页面"返回"主页面/子页面"）
{{SUBPAGENAME}} 系统变量 子页面标题[12]（例如 "帮助:主页面/子页面/二级子页面"中的"二级子页面"）
{{SUBJECTPAGENAME}}
{{ARTICLEPAGENAME}} 		帮助:魔术字/系统变量
帮助:魔术字/系统变量 		返回该页面的本体的完整页面名。即使是在讨论页中也会返回本体页面名（例如在“讨论:讨论板”页面中返回“讨论板”）
{{TALKPAGENAME}} 帮助讨论:魔术字/系统变量 返回该页面的讨论页的完整页面名（例如在“讨论板”页面中返回“讨论:讨论板”）
{{ROOTPAGENAME}} 魔术字 返回该页面的根页面的不含名字空间的页面名[12]（例如："帮助:主页面/子页面/二级子页面"返回"主页面"）

名字空间

系统变量 示例输出 描述
名字空间[13]（以本页面为例）
说明：
  1. 本部分系统变量均可选设置一个参数以获取其他页面的信息，格式为：{{系统变量:页面标题}}，若不设置则默认使用当前页面的标题。
{{NAMESPACE}} 帮助 当前页面名字空间名称
{{NAMESPACENUMBER}} 12 当前页面名字空间ID
{{SUBJECTSPACE}}
{{ARTICLESPACE}} 		帮助
帮助 		返回该页面的本体的名字空间名称
{{TALKSPACE}} 帮助讨论 返回该页面的讨论页的名字空间名称

其他

系统变量 示例输出 描述
其他
{{!}} | 返回一个管道符，它可以在模板嵌套表格或表格嵌套模板之时在被嵌套的表格/模板中代替管道符以免嵌套的模板/表格将其解析导致语法错乱，例如：
{|
|-
| {{colorblock{{!}}red}}
|}

更详细的信息请参阅更多

注释

  1. ↑ 系统服务器时区指的是服务器所在地区的时区或者$wgLocaltimezone设置的时区。
  2. ↑ 2.00 2.01 2.02 2.03 2.04 2.05 2.06 2.07 2.08 2.09 2.10 前导零指的是为了将数字补足到指定长度而在开头补上若干个零，例如8月的前导零补足是08月。
  3. ↑ 3.0 3.1 3.2 此时间戳以YYYYMMDDHHmmss为格式
  4. ↑ 4.0 4.1 本部分系统变量接受一个额外参数，指定特定页面来代替当前页面的元信息：
    • {{PROTECTIONLEVEL: move | Mainpage}} →
    • {{REVISIONID:Mainpage}} →
    但请注意：如果额外参数指定的页面不是当前页面时则属于 [高开销] 系统变量！
  5. ↑ 5.0 5.1 5.2 5.3 动作指的是对页面的操作，包括edit（编辑）、move（移动）、delete（删除）、create（创建）等
  6. ↑ 保护级别指的是对特定操作的可操作用户组的限制，""（空）代表没有限制，"autoconfirm"（半保护）代表只有自动确认用户才可执行操作，"patrolleredit"（仅允许管理员和巡查姬）代表只有巡查姬和管理员才可执行操作，"sysop"（全保护）代表只有管理员才可执行操作
  7. ↑ 7.0 7.1 7.2 7.3 7.4 7.5 7.6 7.7 7.8 7.9 页面最新版本指的是：该页面的最后一个修订版本（页面正常访问时显示的版本）或某编辑者正在预览的版本(该编辑者即使不保存编辑，也会刷新页面最后修订版本的缓存数据)
  8. ↑ 本部分系统变量返回的数字往往包含分隔符（根据页面使用语言可能是逗号或空格），将参数1设为R可以得到无分隔号的数字（例如{{NUMBEROFPAGES}} → 5,604和{{NUMBEROFPAGES:R}} → 5604）。
  9. ↑ 本部分系统变量接受一个参数1，用于指定特定页面来代替当前页面的信息：
    • {{PAGENAME:讨论:讨论板}} → 讨论板
  10. ↑ 本部分系统变量可以通过在系统变量名后加一个E（例如{{PAGENAMEE:...}}）来获得经过MediaWiki URL编码后的标题，这样的标题适合用于指向特定页面的链接中。
    注意{{PAGENAME:...}}、{{PAGENAMEE:...}}和{{urlencode:...}}有不同的实现方式，只有{{PAGENAMEE:...}}才能输出符合MediaWiki URL编码规则的标题，更细节的信息请参阅MediaWiki官网的Manual:PAGENAMEE encoding。
  11. ↑ 警告：当前页面标题如果包含特定字符——例如单引号'、星号*——会导致本部分系统变量有不正常的结果。一种简单的修复方法是使用{{#titleparts:}}解析器函数来处理标题。
    例如，如果页面标题是L'Aquila，下面的结果将会是“Numeric char encoding”： 
    {{#switch:{{PAGENAME}}
| L'Aquila = No translation
| L = Not OK
| L'Aquila = Entity escaping
| L'Aquila = Numeric char encoding
}}
  12. ↑ 12.0 12.1 12.2 此类系统变量仅能实现基础功能，如需要更多匹配请使用{{#titlepars:}}
  13. ↑
    1. 本部分系统变量，除{{NAMESPACENUMBER}}外，可以通过在系统变量名后加一个E（例如{{NAMESPACEE}}）来获得经过MediaWiki URL编码后的分类。
    2. 本部分系统变量接受一个参数1，用于指定特定页面的名字空间来代替当前页面的名字空间：
      • {{NAMESPACE:MediaWiki}} → （空）
      • {{NAMESPACE:模板:主页}} → 模板
      • {{TALKSPACE:模板:主页}} → 模板讨论
      参数必须是一个页面名，即使填入的是一个名字空间名称，MediaWiki也会将其作为页面名处理：
      • {{SUBJECTSPACE:帮助讨论}} → （空）
取自“https://mcbbs.wiki/index.php?title=帮助:魔术字/系统变量&oldid=14331”