帮助:魔术字

来自活字社
跳到导航 跳到搜索

魔术字是MediaWiki软件所识别的特定字符串,它们可以返回特定的值或触发其他的功能:比如时间、站点设置或是页面名称等等。此页面只解释标准魔术字的用法。

魔术字有三种类型:

  • 状态开关:以两个下划线“__”为前后缀的大写单词,例如__FOO__
  • 变量:字符被两个大括号括起来,所有字母大写,例如{{FOO}}。用法与模板类似。
  • 解析器函数:一些形如{{foo:...}}{{#foo:...}}的魔术字,在使用时包含参数,且大小写不敏感。

变量和解析器函数可以像模板一样使用subst:。无论这个魔术字是通过被引用的模板添加的或者被包含的系统信息中添加的,依赖页面的魔术字均将(默认)起作用或者返回当前页面的数据。

行为开关

状态开关可以控制页面的显示方式或其他行为。它往往用于排除或加入特定的页面内容。

文字 描述 版本
目录
__NOTOC__ 隐藏目录(TOC)。
__FORCETOC__ 强制于默认位置(第一个章节标题上方,忽略__NOTOC__的设置)显示目录。
__TOC__ 在魔术字的位置插入目录(忽略__NOTOC__的设置)。如果这个魔术字在一个页面内被多次使用,目录将会被放置在首个__TOC__出现的位置。
编辑
__NOEDITSECTION__ 隐藏章节标题旁的编辑连结。这个特别有用,当章节标题在模板中被创建时,普通的编辑连结将用户带到编辑模板代码界面,这与用户的直觉不符。如果模板包括多个标题,有必要在每个标题后加上“$noeditsection”。
__NEWSECTIONLINK__ 在非讨论页顶端“编辑页面”标签右侧加入一个按钮,用于在页面结尾加入新的章节。 >=1.7
__NONEWSECTIONLINK__ 移除讨论页顶端“编辑页面”右侧的加入新章节连结。 >=1.15
分类
__NOGALLERY__ 用于分类页面。不显示分类中所包含文件的缩略图,而以普通连结代替。 >=1.7
__HIDDENCAT__ 用于分类页面。加入后此分类成为隐藏分类,将不会显示在上级分类其及成员页面的分类列表中。 >=1.13
语言转换
__NOCONTENTCONVERT__
__NOCC__
在语言有不同变体时(如中文简体和繁体),不对当前页面进行字词转换。比如只显示中文,而不是显示大陆简体、台湾繁体、新加坡繁体和香港繁体。
__NOTITLECONVERT__
__NOTC__
在语言有不同变体时(如中文简体和繁体),不对当前页面进行标题转换(其他内容照常转换)。
其他
__START__ 无影响。 <=1.10
__END__ 明确表明文章的结尾,来防止Mediawiki删除文末的空格。 1.1 - 1.8
__INDEX__ 允许搜索引擎检索本页(忽略$wgArticleRobotPolicies的参数设置,但无法忽略robots.txt)。服从$wgExemptFromUserRobotsControl的设定。 >=1.14
__NOINDEX__ 禁止搜索引擎检索本页。服从$wgExemptFromUserRobotsControl的设定。 >=1.14
__STATICREDIRECT__ 用于重定向页。当有人移动页面并勾选“更新所有指向原始标题的重定向”时,禁止MediaWiki更新本页的重定向。(需要变量$wgFixDoubleRedirects) >=1.13

变量

  • {{CURRENTYEAR}}:UTC时间完整年份 -> 2024
  • {{LOCALYEAR}}:服务器时区完整年份 -> 2024