Help:Magic words/zh

魔术字是MediaWiki软件所识别的特定字符串，它们可以返回特定的值或触发其他的功能：比如时间、站点设置或是页面名称等等. 此页面只解释标准魔术字的用法；开发人员请参考.

魔术字有三种常规类型：


 * 状态开关：通常写成以两个下划线为前后缀的大写单词，例如 .
 * 变量：字符被两个大括号括起来，所有字母大写，例如 . 用法与模板类似.
 * 解析器函数：可以创造参数，既可以是格式 ，也可以是 ，例如. 参见和.

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

状态开关
状态开关可以控制页面（只要受皮肤支持）的显示方式或其他行为. 它往往用于排除或加入特定的页面内容. 这些魔术字中，有一部分不受Minerva皮肤支持.

变量
变量可以返回关于当前页面、wiki站点或日期的信息. 变量的语法与模板类似. 其中标记为“ [高开销] ”的变量会被软件记录，且在一个页面中可使用的总数会被限制.

如果某一模板名与变量名重复，软件会自动将其解释为变量（因此若要包含   :PAGENAME，页面中需要写作 ）. 在某些情况下，加入参数会强制软件将变量视作一个模板，如 将会包含   :CURRENTDAYNAME，而不是变量.

日期和时间
以下的变量返回当前的日期和UTC时间.

在MediaWiki与浏览器缓存的影响下，这些变量显示的往往是被缓存的值，而非当前的时间.

使用这些变量会使页面被缓存的时间变得更短，这可以通过 MagicWordFactory 设置.

日期和时间魔术字被格式化为相应的语种. 自版本开始，它们取决于页面内容语言.

{{note|1= {{tlx|CURRENTDATE}} is not a magic word but it might be a template.

如下变量和上列变量功能相同，但是使用的是所在服务器的时间或者{{mediawiki|Special:MyLanguage/Manual:$wgLocaltimezone|$wgLocaltimezone}}.



''如果需要更详尽的时间格式，或是在輸出目前年份和星期時更好的遵守ISO-8601，您可以在安装{{ll|Extension:ParserFunctions}}后使用{{ll|Help:Extension:ParserFunctions#.23time| # time}}解释器函数. ''

{{anchor|Technical metadata}}

统计
这些变量返回的数字往往包含分隔符（根据本地语言参数设置而可能是逗号或空格）. 可以通过“:R”来返回无分隔号的数字（例如 &rarr; 和  &rarr; ）.

对于PAGESINCATEGORY等需要参数的变量则使用“|R”（例如 和 及 和 ）. 并且也适用于前述.

返回数字的魔术字数字格式取决于内容语言的设定. 自开始，它取决于页面内容语言.

页面名称
这些变量不受  影响，它们都会按原来的页面标题计算返回值.

和 这两个魔术字只在启用了子页面模式的名字空间才生效. 关于启用子页面模式请看.

在1.15+之后，以上魔术字可以接受一个参数，用于指定特定页面，来代替要处理的当前页面设定：



URL 編碼後的頁面名稱
以下是在MediaWiki URL中的等价编码（就是空格替换为下划线，以及使用数字字符编码的一些HTML溢出字符）：



注意 、 和 有不同的实现方式. See for details.

名字空间
以下是在MediaWiki URL中的的等价编码（空格替换为下划线，一些字符替换为百分号编码）：



在1.15+开始，这些可以是完整页面名参数，并将返回与那个页面相关的请求名字空间，而不是在当前页面中：

参数必须不是一个名字空间名称：
 * &rarr; 
 * &rarr;  (Pages in main space will return empty)
 * &rarr; 
 * &rarr; 
 * &rarr; 
 * &rarr; 
 * &rarr;   (Empty)

解析器函数
解析器函数与变量相似，但需要一个或多个参数（技术上讲，任何需要参数的魔术字都是解析器函数），并且名称有时以井号（hash）开头，以与模板区分开来.

此页面只描述MediaWiki软件中重要的解析器函数. 其他MediaWiki软件可能添加的解析器函数包括等，请参见.

名字空间
使用该索引，规范名称或本地别名返回名字空间的当前本地化名称. 因此 ， 和 （File名称空间的旧名称）都返回. 在内容语言为法语的wiki上， 也有效，但 （德语中“File”的本地化）不是.

是MediaWiki URL的等效编码. 它也是这样，但它用下划线替换空格，使其可用于外部链接.

不要将本地化名字空间与自定义名字空间相混淆.

格式化
参见：.

本地化
这些是用于本地化工具的魔术字. 其他的魔术字经常依赖wiki的本地化和位置，或者其他已选的语言，参见特定的#日期和时间、#格式化、杂项. 更多的魔术字由添加.

魔术字的用法会非常复杂，而且文档目前还不完整，PLURAL、GRAMMAR、GENDER上有更多信息.

嵌入修改器
默认从 Template: 名字空间嵌入页面. 这些魔术字会修改那个行为.

杂项
For parser function #invoke, see w:Wikipedia:Lua.