帮助:魔术字/系统变量

这篇帮助文档的难度为:困难
这篇帮助文档比较复杂,适合资深编辑者阅读。阅读这篇帮助文档前,您需要熟练掌握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时区,下同)[2]
{{LOCALMONTH}}
{{CURRENTMONTH}}
11
11
当前月份(补足前导零[3]
{{LOCALMONTH1}}
{{CURRENTMONTH1}}
11
11
当前月份(不补足前导零[3]
{{LOCALMONTHNAME}}
{{CURRENTMONTHNAME}}
11月
11月
当前月份(以当前语言月份名为内容)
{{LOCALMONTHNAMEGEN}}
{{CURRENTMONTHNAMEGEN}}
11月
11月
当前月份(以当前语言月份名的所有格为内容)
{{LOCALMONTHABBREV}}
{{CURRENTMONTHABBREV}}
11月
11月
当前月份(以当前语言月份名的缩写为内容)
{{LOCALDAY}}
{{CURRENTDAY}}
24
24
输出今天是几号(不补足前导零[3]
{{LOCALDAY2}}
{{CURRENTDAY2}}
24
24
输出今天是几号(补足前导零[3]
{{LOCALDOW}}
{{CURRENTDOW}}
0
0
输出今天是星期几(不补足前导零[3]),以0-6代指,0指星期天,6指星期六
{{LOCALDAYNAME}}
{{CURRENTDAYNAME}}
星期日
星期日
输出今天是星期几(以当前语言星期数名为内容)
{{LOCALTIME}}
{{CURRENTTIME}}
16:32
08:32
当前时间(24小时制)(输出格式为“小时数:分钟数”,全部补足前导零[3]
{{LOCALHOUR}}
{{CURRENTHOUR}}
16
08
当前小时数(24小时制,补足前导零[3]
{{LOCALWEEK}}
{{CURRENTWEEK}}
47
47
输出当前第几周
{{LOCALTIMESTAMP}}
{{CURRENTTIMESTAMP}}
20241124163222
20241124083222
时间戳[4]

站点技术元数据

系统变量 示例输出 描述
站点技术元数据
{{SITENAME}} MCBBS Wiki 站点名称(由$wgSitename设置)
{{SERVER}} https://mcbbs.wiki 站点域名URL(由$wgServer设置)
{{SERVERNAME}} mcbbs.wiki 输出子域名和域名(不再取决于$wgServer
{{DIRMARK}}
{{DIRECTIONMARK}}

输出站点默认语言所使用的Unicode文本方向控制字符(从左到右书写的语言使用‎,反之使用‏
{{SCRIPTPATH}} 脚本(index.php、load.php、api.php等)相对路径(由$wgScriptPath设置)
{{STYLEPATH}} /skins 皮肤样式相对路径(由$wgStylePath设置)
{{CURRENTVERSION}} 1.40.3 站点MediaWiki版本
{{CONTENTLANGUAGE}}
{{CONTENTLANG}}
zh-cn
zh-cn
站点默认界面语言(由$wgLanguageCode设置)

页面技术元数据

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

页面最新版本

系统变量 示例输出 描述
页面最新版本[8]信息(以本页面为例)(参数说明[5]
{{REVISIONID}} 35046 页面最新版本[8]的版本ID
{{REVISIONDAY}} 12 输出页面最新版本[8]的修订日期是几号(不补足前导零[3]
{{REVISIONDAY2}} 12 输出页面最新版本[8]的修订日期是几号(补足前导零[3]
{{REVISIONMONTH}} 07 页面最新版本[8]的修订日期的月份(补足前导零[3]
{{REVISIONMONTH1}} 7 页面最新版本[8]的修订日期的月份(不补足前导零[3]
{{REVISIONYEAR}} 2022 页面最新版本[8]的修订日期的年份
{{REVISIONTIMESTAMP}} 20220712133401 页面最新版本[8]的修订日期的时间戳[4]
{{REVISIONUSER}} HerobrineinMF 页面最新版本[8]的编辑者
{{REVISIONSIZE}} 20431 页面最新版本[8]的wikitext源码的大小(单位:byte)

站点数据统计

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

页面名称

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

名字空间

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

扩展:编辑计数

此扩展因为兼容性问题已停用。

系统变量 示例输出 描述
扩展:编辑计数(以用户User:Eicy为例)
说明:
  1. 本部分系统变量均为编辑计数扩展提供的系统变量,用于计算指定用户的编辑数。
  2. 此扩展在Wiki升级后因为兼容性问题已停用。
{{Special:Editcount/Eicy}} 此扩展在Wiki升级后因为兼容性问题已停用。 总编辑数
{{Special:Editcount/Eicy/}} 此扩展在Wiki升级后因为兼容性问题已停用。 主页面编辑数
(输入任何无法识别的参数或留空都将默认为主页面)
{{Special:Editcount/Eicy/Talk}}
{{Special:Editcount/Eicy/讨论}}
此扩展在Wiki升级后因为兼容性问题已停用。 该名字空间的编辑数

其他

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

更详细的信息请参阅MediaWiki相关资料

注释

  1. 系统服务器时区指的是服务器所在地区的时区或者$wgLocaltimezone设置的时区。
  2. LOCAL指本地时间,在MCBBS Wiki即为北京时间(UTC+8),CURRENT指UTC+0。在某些其他Wiki(如Fandom),你会发现它们是相同的。
  3. 3.00 3.01 3.02 3.03 3.04 3.05 3.06 3.07 3.08 3.09 3.10 前导零指的是为了将数字补足到指定长度而在开头补上若干个零,例如8月的前导零补足是08月。
  4. 4.0 4.1 4.2 此时间戳以YYYYMMDDHHmmss为格式
  5. 5.0 5.1 本部分系统变量接受一个额外参数,指定特定页面来代替当前页面的元信息:
    • {{PROTECTIONLEVEL: move | Mainpage}}
    • {{REVISIONID:Mainpage}}
    但请注意:如果额外参数指定的页面不是当前页面时则将会是一个高开销的系统变量!
  6. 6.0 6.1 6.2 6.3 动作指的是对页面的操作,包括edit(编辑)、move(移动)、delete(删除)、create(创建)等
  7. 保护级别指的是对特定操作的可操作用户组的限制,""(空)代表没有限制,"autoconfirm"(仅允许自动确认用户)代表只有自动确认用户才可执行操作,"patrolleredit"(仅允许管理员和巡查员)代表只有巡查员和管理员才可执行操作,"sysop"(全保护)代表只有管理员才可执行操作
  8. 8.0 8.1 8.2 8.3 8.4 8.5 8.6 8.7 8.8 8.9 页面最新版本指的是:该页面的最后一个修订版本(页面正常访问时显示的版本)或某编辑者正在预览的版本(该编辑者即使不保存编辑,也会刷新页面最后修订版本的缓存数据)
  9. 本部分系统变量返回的数字往往包含分隔符(根据页面使用语言可能是逗号或空格),将参数1设为R可以得到无分隔号的数字(例如{{NUMBEROFPAGES}} → 5,681和{{NUMBEROFPAGES:R}} → 5681)。
  10. 本部分系统变量接受一个参数1,用于指定特定页面来代替当前页面的信息:
    • {{PAGENAME:讨论:讨论板}} → 讨论板
  11. 本部分系统变量可以通过在系统变量名后加一个E(例如{{PAGENAMEE:...}})来获得经过MediaWiki URL编码后的标题,这样的标题适合用于指向特定页面的链接中。
    注意{{PAGENAME:...}}{{PAGENAMEE:...}}{{urlencode:...}}有不同的实现方式,只有{{PAGENAMEE:...}}才能输出符合MediaWiki URL编码规则的标题,更细节的信息请参阅MediaWiki官网的Manual:PAGENAMEE encoding
    1. 本部分系统变量,{{NAMESPACENUMBER}},可以通过在系统变量名后加一个E(例如{{NAMESPACEE}})来获得经过MediaWiki URL编码后的分类。
    2. 本部分系统变量接受一个参数1,用于指定特定页面的名字空间来代替当前页面的名字空间:
      • {{NAMESPACE:MediaWiki}} → (空)
      • {{NAMESPACE:模板:主页}} → 模板
      • {{TALKSPACE:模板:主页}} → 模板讨论
      参数必须是一个页面名,即使填入的是一个名字空间名称,MediaWiki也会将其作为页面名处理:
      • {{SUBJECTSPACE:帮助讨论}} → (空)