社区文档构建进行中，欢迎编辑。社区答疑群（非官方）：717421103

全站通知：

帮助:魔术字

来自WIKI实验室WIKI_BWIKI_哔哩哔哩
跳到导航 跳到搜索
短•刷•阅•编•历

魔术字（Magic words）是MediaWiki软件所识别的特定字符串，它们可以返回特定的值或触发其他的功能。魔术字有如下三种：

  • 状态开关：以两个下划线“__”为前后缀的大写单词。例如__NOTOC__；
  • 系统变量：同模版类似，以被两个大括号括起来，且所有字母大写，如{{FOO}}；
  • 解析器函数：这些形如{{foo:...}}或{{#foo:...}}的魔术字在使用时包含参数，且函数名称对大小写不敏感（包括可大小写混用）。

状态开关

状态开关可以控制包括页面界面、页面行为等在内的各项内容，也可以用来要求页面提供需要的内容。

状态开关 描述
目录相关
__NOTOC__
__无目录__ 		隐藏目录。
__FORCETOC__
__强显目录__ 		强制显示目录（即使各级标题总和不足4个）（覆盖__NOTOC__）
__TOC__
__目录__ 		指定目录生成的位置（覆盖__NOTOC__）。多次插入使用时，目录会出现在文章中第一次出现该魔术字的位置。
标题相关
__NOTITLE__ 隐藏页面标题（#FirstHeading）。
编辑相关
__NOEDITSECTION__
__无编辑段落__
__无段落编辑__ 		隐藏章节标题旁的编辑链接。 在模板中使用它将扩充对模板嵌入页面的影响，以及任何包含在同一页面的其他模板。
__NEWSECTIONLINK__
__新段落链接__ 		在非讨论页顶端“编辑”标签右侧加入一个按钮，用于在页面结尾加入新的章节。
__NONEWSECTIONLINK__
__无新段落链接__ 		移除讨论页顶端“编辑”右侧的加入新章节链接。
分类相关
__NOGALLERY__
__无图库__ 		令包含图片的分类页以普通链接形式列举图片，而不是通常的以缩略图图库形式。
__HIDDENCAT__
__隐藏分类__ 		用于分类页面。加入后此分类成为隐藏分类，将不会显示在上级分类其及成员页面的分类列表中（用户可以在设置#显示的“高级选项”中启用“显示隐藏分类”功能）
__EXPECTUNUSEDCATEGORY__ 在分类页面上使用，使该分类不在特殊:未使用分类中列出。
语言转换相关
__NOCONTENTCONVERT__
__NOCC__
__不转换内容__ 		在语言有不同变体时（如中文简体和繁体），不对当前页面进行字词转换。比如只显示中文，而不是显示大陆简体、台湾繁体、新加坡简体和香港繁体。
__NOTITLECONVERT__
__NOTC__
__不转换标题__ 		在语言有不同变体时（如中文简体和繁体），不对当前页面进行标题转换（其他内容照常转换）。
其他相关
__INDEX__
__索引__ 		本开关可以要求外部搜索引擎索引页面（覆盖$wgArticleRobotPolicies设置但无法覆盖robots.txt设置，遵循$wgExemptFromUserRobotsControl设置）
__NOINDEX__
__无索引__ 		本开关可以要求外部搜索引擎不索引本页面（遵循$wgExemptFromUserRobotsControl设置）
__STATICREDIRECT__
__静态重定向__ 		仅在重定向页使用，当用户移动重定向页A所重定向的页面B到页面C时，用户可以选择“更新所有指向原始标题的重定向”，此时页面A的重定向将会更新到C；如若页面A使用本开关，将不会被更新重定向

系统变量

返回关于日期与时间、系统、页面的信息，其wikitext格式与模板非常相似，但是只有一部分系统变量接受参数。被标记为 [高开销] 的系统变量的使用将会被MediaWiki追踪，并且同一页面上能使用的高开销系统变量的数量是有限制的。
系统变量的结果有可能被缓存，此时使用“强制刷新页面”工具可能可以获得最新数据。

系统变量 示例输出 描述
日期与时间
以LOCAL开头的变量为当地时间（wiki默认值为亚洲/Shanghai - UTC+8），以CURRENT开头的变量为服务器时间（世界统一时间 - UTC 0）
年
{{LOCALYEAR}}
{{CURRENTYEAR}} 		2024
2024 		当前年份
月
{{LOCALMONTH}}
{{LOCALMONTH2}}
{{CURRENTMONTH}}
{{CURRENTMONTH2}} 		12
12
12
12 		当前月份（补足前导零）
{{LOCALMONTH1}}
{{CURRENTMONTH1}} 		12
12 		当前月份（不补足前导零）
{{LOCALMONTHNAME}}
{{CURRENTMONTHNAME}} 		12月
12月 		当前月份（以当前语言月份名为内容）
{{LOCALMONTHNAMEGEN}}
{{CURRENTMONTHNAMEGEN}} 		12月
12月 		当前月份（以当前语言月份名的所有格为内容）
{{LOCALMONTHABBREV}}
{{CURRENTMONTHABBREV}} 		12月
12月 		当前月份（以当前语言月份名的缩写为内容）
日
{{LOCALDAY}}
{{CURRENTDAY}} 		22
22 		输出今天是几号（不补足前导零）
{{LOCALDAY2}}
{{CURRENTDAY2}} 		22
22 		输出今天是几号（补足前导零）
{{LOCALDOW}}
{{CURRENTDOW}} 		0
0 		输出今天是星期几（不补足前导零），以0-6代指，0指星期天，6指星期六
{{LOCALDAYNAME}}
{{CURRENTDAYNAME}} 		星期日
星期日 		输出今天是星期几（以当前语言星期数名为内容）
时间
{{LOCALTIME}}
{{CURRENTTIME}} 		17:13
09:13 		当前时间（24小时制）（输出格式为“小时数:分钟数”，全部补足前导零）
{{LOCALHOUR}}
{{CURRENTHOUR}} 		17
09 		当前小时数（24小时制，补足前导零）
其他
{{LOCALWEEK}}
{{CURRENTWEEK}} 		51
51 		输出当前第几周
{{LOCALTIMESTAMP}}
{{CURRENTTIMESTAMP}} 		20241222171325
20241222091325 		时间戳
站点技术元数据
{{SITENAME}} WIKI实验室WIKI_BWIKI_哔哩哔哩 站点名称（由$wgSitename设置）
{{SERVER}} https://wiki.biligame.com 站点域名URL（由$wgServer设置）
{{SERVERNAME}} wiki.biligame.com 输出子域名和域名（不再取决于$wgServer）
{{DIRMARK}}
{{DIRECTIONMARK}} 		‎
‎ 		输出站点默认语言所使用的Unicode文本方向控制字符（从左到右书写的语言使用‎，反之使用‏）
{{ARTICLEPATH}} /tools/$1 相关文章路径（由$wgArticlePath设置）
{{SCRIPTPATH}} /tools 脚本（index.php、load.php、api.php等）相对路径（由$wgScriptPath设置）
{{STYLEPATH}} https://staticwiki.biligame.com/skins 皮肤样式相对路径（由$wgStylePath设置）
{{CURRENTVERSION}} 1.37.0 站点MediaWiki版本
{{CONTENTLANGUAGE}}
{{CONTENTLANG}} 		zh-cn
zh-cn 		站点默认界面语言（由$wgLanguageCode设置）
页面技术元数据（以本页面为例）
说明：
  1. 本部分系统变量接受一个额外参数，指定特定页面来代替当前页面的元信息：
    • {{PROTECTIONLEVEL: move | 首页}} →
    • {{REVISIONID:首页}} → 50579
    但请注意：如果额外参数指定的页面不是当前页面时则属于 [高开销] 系统变量！
{{PAGELANGUAGE}}
{{#language:{{PAGELANGUAGE}}}} 		zh-cn
中文（中国大陆） 		返回当前页面的语言。此变量返回的语言代码可使用{{#language:...}}转换为语言名。
{{PAGEID}} 2501 当前页面ID
{{PROTECTIONLEVEL:edit}} 输出当前页面对指定操作的保护级别。若未保护则返回空字符串
{{PROTECTIONEXPIRY:edit}} infinity 输出当前页面对指定操作的保护时长，若时长无限则返回"infinity"，否则返回结束时刻的时间戳
{{CASCADINGSOURCES}} [高开销] 输出在本页面生效的级联保护的来源页面。除非页面自我嵌入（例如在一个在<noinclude/>说明文本内嵌入自己的模板）且设置了级联保护，否则不会输出页面自身的名字
页面最新版本信息（以本页面为例）
说明：
  1. 本部分系统变量接受一个额外参数，指定特定页面来代替当前页面的元信息：
    • {{PROTECTIONLEVEL: move | 首页}} →
    • {{REVISIONID:首页}} → 50579
    但请注意：如果额外参数指定的页面不是当前页面时则属于 [高开销] 系统变量！
{{REVISIONID}} 50253 页面最新版本的版本ID，在预览中为空，因此能用来显示仅限于预览时的错误讯息。可能在吝啬模式中被停用。
{{REVISIONDAY}} 2 输出页面最新版本的修订日期是几号（不补足前导零）
{{REVISIONDAY2}} 02 输出页面最新版本的修订日期是几号（补足前导零）
{{REVISIONMONTH}} 11 页面最新版本的修订日期的月份（补足前导零）
{{REVISIONMONTH1}} 11 页面最新版本的修订日期的月份（不补足前导零）
{{REVISIONYEAR}} 2024 页面最新版本的修订日期的年份
{{REVISIONTIMESTAMP}} 20241102204620 页面最新版本的修订日期的时间戳
{{REVISIONUSER}} 141211391 页面最新版本的编辑者
{{REVISIONSIZE}} 25702 页面最新版本的wikitext源码的大小（单位：byte）
站点数据统计
说明：
  1. 本部分系统变量返回的数字往往包含分隔符（根据页面使用语言可能是逗号或空格），将参数1设为R可以得到无分隔号的数字（例如{{NUMBEROFPAGES}} → 2,318和{{NUMBEROFPAGES:R}} → 2318）。
{{NUMBEROFPAGES}} 2,318 站点页面个数
{{NUMBEROFARTICLES}} 154 内容名字空间下的页面个数
{{NUMBEROFFILES}} 177 已上传的文件个数
{{NUMBEROFEDITS}} 16,110 站点编辑次数
{{NUMBEROFVIEWS}} 1,379,861 wiki浏览总次数。通常对使用缓存的wiki无效。
{{NUMBEROFUSERS}} 7,494,737 站点用户数量
{{NUMBEROFADMINS}} 17 管理员（sysop）数量
{{NUMBEROFACTIVEUSERS}} 10 活跃用户数量，活跃用户的标准与Special:活跃用户的一样
{{PAGESINCATEGORY:分类名称}}
{{PAGESINCAT:分类名称}} 		155
155 		[高开销] 输出指定分类中的页面总数（包括子类和文件）（以分类:帮助为示例）
  1. {{PAGESINCATEGORY:-{}-分类名称|all}}
  2. {{PAGESINCATEGORY:-{}-分类名称|pages}}
  3. {{PAGESINCATEGORY:-{}-分类名称|subcats}}
  4. {{PAGESINCATEGORY:-{}-分类名称|files}}
  1. 155
  2. 155
  3. 0
  4. 0
 [高开销] 输出指定分类的：
  1. 所有页面数
  2. 所有非分类页和非文件页的页面数
  3. 所有子分类页面数
  4. 所有文件页面数

（以分类:帮助为示例）

{{NUMBERINGROUP:用户组}}
{{NUMINGROUP:用户组}} 		8 ({{NUMBERINGROUP:bureaucrat}})
0（{{NUMINGROUP:patroller}}） 		特定用户组中的用户总数
影响页面内容
{{DISPLAYTITLE:帮助:魔术字}}
{{DISPLAYTITLE:帮助:魔术字|noerror}}
{{DISPLAYTITLE:帮助:魔术字|noreplace}}

设置当前页面的显示标题，可以使用第二个参数noerror或是noreplace，用来在当有多个标题在一个页面使用时，阻止产生错误消息，或是在页面中的前面已经指定了了一个displaytitle的情况下，使此displaytitle失效。
{{DEFAULTSORT:排序关键字}}
{{DEFAULTSORTKEY:排序关键字}}
{{DEFAULTCATEGORYSORT:排序关键字}}
{{DEFAULTSORT:排序关键字|noerror}}
{{DEFAULTSORT:排序关键字|noreplace}} 		在为页面分类时使用，用来设置当前页面默认的分类排序关键字。例如当你将{{DEFAULTSORT:Smith, John}}放到页面John Smith的结尾，该页面在分类页面上的列表中将默认排到“S”项下。 可以使用第二个参数noerror或是noreplace，用来在当有多个默认排序关键字在一个页面使用时，阻止产生错误消息，或是在页面中的前面已经指定了了一个defaultsort的情况下，使此defaultsort失效。
页面名称（以本页面为例）
说明：
  1. 这些变量不受{{DISPLAYTITLE:xxxx}}影响，它们都会按原来的页面标题计算返回值。
  2. 本部分系统变量接受一个参数1，用于指定特定页面来代替当前页面的信息：
    • {{PAGENAME:-{}-Talk:提问求助区}} → 提问求助区
  3. 本部分系统变量可以通过在系统变量名后加一个E（例如{{PAGENAMEE:...}}）来获得经过MediaWiki URL编码后的标题，这样的标题适合用于指向特定页面的链接中。
    注意{{PAGENAME:...}}、{{PAGENAMEE:...}}和{{urlencode:...}}有不同的实现方式，只有{{PAGENAMEE:...}}才能输出符合MediaWiki URL编码规则的标题，更细节的信息请参阅MediaWiki官网的Manual:PAGENAMEE encoding。
警告：
  1. 部分系统变量会将页面标题的特定字符——例如单引号'、星号*——转义。
    例如，如果页面标题是L'Aquila，{{subst:PAGENAME}}保存后将会是L&#39;Aquila。
    若要避免转义，一种简单的方法是使用{{#titleparts:}}解析器函数来处理标题。
{{FULLPAGENAME}} 帮助:魔术字 包含名字空间的完整页面标题
{{FULLPAGENAMEE}} %E5%B8%AE%E5%8A%A9:%E9%AD%94%E6%9C%AF%E5%AD%97 见说明3，下不再列出
{{PAGENAME}} 魔术字 不包含名字空间的完整页面标题
{{BASEPAGENAME}} 魔术字 不包含名字空间和当前子页面标题的页面标题（例如："Help:Title/foo/bar"返回"Title/foo"）
{{SUBPAGENAME}} 魔术字 子页面标题（例如 "Help:Title/foo/bar"中的"bar"）
{{SUBJECTPAGENAME}}
{{ARTICLEPAGENAME}} 		帮助:魔术字
帮助:魔术字 		返回该页面的本体的完整页面名。即使是在讨论页中也会返回本体页面名（例如在“Talk:提问求助区”页面中返回“提问求助区”）
{{TALKPAGENAME}} 帮助讨论:魔术字 返回该页面的讨论页的完整页面名（例如在“提问求助区”页面中返回“Talk:提问求助区”）
{{ROOTPAGENAME}} 魔术字 返回该页面的根页面的不含名字空间的页面名（例如："Help:Title/foo/bar"返回"Title"）
名字空间（以本页面为例）
说明：
  1. 本部分系统变量，除{{NAMESPACENUMBER}}外，可以通过在系统变量名后加一个E（例如{{NAMESPACEE}}）来获得经过MediaWiki URL编码后的分类。
  2. 本部分系统变量接受一个参数1，用于指定特定页面的名字空间来代替当前页面的名字空间（若不设置则默认使用当前页面的标题）：
    • {{NAMESPACE:MediaWiki}} → （空）
    • {{NAMESPACE:Template:Main Page}} → 模板
    • {{TALKSPACE:Template:Main Page}} → 模板讨论
    如果参数1不为空，则该参数名只会被MediaWiki理解成一个页面名，即使填入的是一个名字空间名称，MediaWiki也会将其作为页面名处理：
    • {{SUBJECTSPACE:Help talk}} → （空）
{{NAMESPACE}} 帮助 当前页面名字空间名称
{{NAMESPACEE}} %E5%B8%AE%E5%8A%A9 见说明1，下不再列出
{{NAMESPACENUMBER}} 12 当前页面名字空间ID
{{SUBJECTSPACE}}
{{ARTICLESPACE}} 		帮助
帮助 		返回该页面的本体的名字空间名称
{{TALKSPACE}} 帮助讨论 返回该页面的讨论页的名字空间名称
其他
{{!}} | 返回一个管道符，它可以在模板嵌套表格或表格嵌套模板之时在被嵌套的表格/模板中代替管道符以免嵌套的模板/表格将其解析导致语法错乱，例如：
{|
|-
| {{colorblock{{!}}red}}
|}

更详细的信息请参阅MediaWiki网站文档。

注释与外部链接

取自“https://wiki.biligame.com/tools/index.php?title=帮助:魔术字&oldid=50253”