Help:魔术字：修订间差异

{{NoteTA

| G1 = MediaWiki

| G2 = IT

{{not|Help:解析器函数}}

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

魔术字有三种常规类型：

* '''[[#Behavior switches|状态开关]]'''：通常写成以两个下划线为前后缀的大写单词，例如'''<code>__FOO__</code>'''。

* '''[[#Variables|变量]]'''：字符被两个大括号括起来，所有字母大写，例如'''<code><nowiki>{{FOO}}</nowiki></code>'''。用法与[[Help:模板|模板]]类似。

* '''[[#Parser functions|解析器函数]]'''：可以创造参数，既可以是格式'''<code><nowiki>{{foo:...}}</nowiki></code>'''，也可以是'''<code><nowiki>{{#foo:...}}</nowiki></code>'''。参见[[Help:解析器函数]]和[[Help:Lua|Lua]]。

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

<span id="Behavior_switches"></span>

状态开关可以控制页面（只要受皮肤支持）的显示方式或其他行为。它往往用于排除或加入特定的页面内容。

! width="20%" colspan="2" | 文字

! 描述

! colspan="3" style="background-color: #DDDDDD;" | 目录

{{Table-AnchorRow|NOTOC}}

| colspan="2" | <code><nowiki>__NOTOC__</nowiki></code>

| 隐藏目录（TOC）。

{{Table-AnchorRow|FORCETOC}}

| colspan="2" | <code><nowiki>__FORCETOC__</nowiki></code>

| 强制于默认位置（第一个章节标题上方，忽略<code><nowiki>__NOTOC__</nowiki></code>的设置）显示目录。 此魔术字对于在文章内容外展示目录的皮肤不起作用。

{{Table-AnchorRow|TOC}}

| colspan="2" | <code><nowiki>__TOC__</nowiki></code>

| 在魔术字的位置插入目录（忽略<code><nowiki>__NOTOC__</nowiki></code>的设置）。 多次使用时，目录会出现在文章中第一次出现该魔术字的位置。 此魔术字对于在文章内容外展示目录的皮肤不起作用。

! colspan="3" style="background-color: #DDDDDD;" | 编辑

{{Table-AnchorRow|NOEDITSECTION}}

| colspan="2" | <code><nowiki>__NOEDITSECTION__</nowiki></code>

| 隐藏章节标题旁的编辑链接。这个特别有用，当章节标题在模板中被创建时，普通的编辑链接将会把用户带到编辑模板代码界面，这与用户的直觉不符。 在模板中使用它将扩充对模板嵌入页面的影响，以及任何包含在同一页面的其他模板。

{{Table-AnchorRow|NEWSECTIONLINK}}

| colspan="2" | <code><nowiki>__NEWSECTIONLINK__</nowiki></code>

| 在非讨论页顶端“{{int|vector-view-edit}}”标签右侧加入一个按钮，用于在页面结尾加入新的章节。

{{Table-AnchorRow|NONEWSECTIONLINK}}

| colspan="2" | <code><nowiki>__NONEWSECTIONLINK__</nowiki></code>

| 移除讨论页顶端“{{int|vector-view-edit}}”右侧的加入新章节链接。

! colspan="3" style="background-color: #DDDDDD;" | 分类

{{Table-AnchorRow|NOGALLERY}}

| colspan="2" | <code><nowiki>__NOGALLERY__</nowiki></code>

| 用于分类页面。不显示分类中所包含文件的缩略图，而以普通链接代替。

{{Table-AnchorRow|HIDDENCAT}}

| colspan="2" | <code><nowiki>__HIDDENCAT__</nowiki></code>

| 用于分类页面。加入后此分类成为隐藏分类，将不会显示在上级分类其及成员页面的分类列表中（可以通过[[Help:参数设置|参数设置]]中的选项强制显示）。<!-- hiddencategory hiddencat hide category categories -->

{{Table-AnchorRow|EXPECTUNUSEDCATEGORY}}

| colspan="2" | <code><nowiki>__EXPECTUNUSEDCATEGORY__</nowiki></code>

| 在分类页面上使用，从[[Special:UnusedCategories]]中删除分类。

! colspan="3" style="background-color: #DDDDDD;" | 语言转换

{{Table-AnchorRow|NOCONTENTCONVERT|NOCC}}

| colspan="2" | <code><nowiki>__NOCONTENTCONVERT__</nowiki></code> <br> <code><nowiki>__NOCC__</nowiki></code>

| 在语言有不同变体时（如中文简体和繁体），不对当前页面进行字词转换。比如只显示中文，而不是显示大陆简体、台湾繁体、新加坡简体和香港繁体。

{{Table-AnchorRow|NOTITLECONVERT|NOTC}}

| colspan="2" | <code><nowiki>__NOTITLECONVERT__</nowiki></code> <br> <code><nowiki>__NOTC__</nowiki></code>

| 在语言有不同变体时（如中文简体和繁体），不对当前页面进行标题转换（其他内容照常转换）。

! colspan="3" style="background-color: #DDDDDD;" | 其他

{{Table-AnchorRow|START}}

| colspan="2" | <code><nowiki>__START__</nowiki></code>

| 无影响。 曾用于指向不应被嵌入的注释之后开始的数据库消息。

{{Table-AnchorRow|END}}

| colspan="2" | <code><nowiki>__END__</nowiki></code>

| 明确标记条目的结尾，来防止MediaWiki移除文末的空格。

{{Table-AnchorRow|INDEX}}

| colspan="2" | <code><nowiki>__INDEX__</nowiki></code>

| 允许搜索引擎检索本页（忽略<code>$wgArticleRobotPolicies</code>的参数设置但并无法忽略robots.txt）。服从<code>$wgExemptFromUserRobotsControl</code>的设定。

{{Table-AnchorRow|NOINDEX}}

|-

| colspan="2" | <code><nowiki>__NOINDEX__</nowiki></code>

| 禁止搜索引擎检索本页（比如不可在搜索引擎列出指定页面）。服从<code>$wgExemptFromUserRobotsControl</code>的设定。

{{Table-AnchorRow|STATICREDIRECT}}

|-

| colspan="2" | <code><nowiki>__STATICREDIRECT__</nowiki></code>

| 用于一些重定向页面。当有人移动页面并勾选“{{int|Fix-double-redirects}}”时，禁止MediaWiki更新本页的重定向（需要变量<code>$wgFixDoubleRedirects</code>）。

|-

! colspan="3" style="background-color: #DDDDDD;" | 来自扩展

|-

! width="10%" | 扩展

! width="10%" | 文字

! 描述

{{Table-AnchorRow|DISAMBIG}}

|-

| Disambiguator

| <code><nowiki>__DISAMBIG__</nowiki></code>

| 标记消歧义页面。

<span id="Variables"></span>

== -{zh-hans:变量; zh-hant:變數;}- ==

变量可以返回关于当前页面、wiki站点或日期的信息。变量的语法与[[Help:模板|模板]]类似。其中标记为“<span style="background: #FED;">'''[高开销]'''</span>”的变量会被软件记录，且在一个页面中可使用的总数会被限制。

如果某一模板名与变量名重复，软件会自动将其解释为变量（因此若要包含{{tmpl|0=[[{{ns:10}}:$1]]|PAGENAME}}，页面中需要写作 {{tmpl|0=<code><nowiki>{{</nowiki>{{ns:10}}:$1<nowiki>}}</nowiki></code>|PAGENAME}}

部分情况下，添加参数会迫使解析器调用模板；例如，写<code><nowiki>{{CURRENTDAYNAME|x}}</nowiki></code>会导致调用[[{{ns:10}}:CURRENTDAYNAME]]，而'''不是'''所期望的魔术字。

<span id="Date_and_time"></span>

=== 日期和时间 ===

以下的变量返回当前的日期和[[UTC|UTC]]时间。

使用这些变量会使页面被缓存的时间变得更短，这可以通过 [https://github.com/wikimedia/mediawiki/blob/master/includes/MagicWordFactory.php#L122 MagicWordFactory] 设置。

日期和时间魔术字被格式化为相应的语种，取决于页面内容语言。

{| class="wikitable"

! 变量

! 输出

! 描述

! colspan="3" style="background-color: #DDDDDD;" | 年

{{Table-AnchorRow|CURRENTYEAR}}

| <code><nowiki>{{CURRENTYEAR}}</nowiki></code>

! colspan="3" style="background-color: #DDDDDD;" | 月

{{Table-AnchorRow|CURRENTMONTH|CURRENTMONTH1|CURRENTMONTHNAME|CURRENTMONTHNAMEGEN|CURRENTMONTHABBREV}}

| <code><nowiki>{{CURRENTMONTH}}</nowiki></code>

| 月（补足前导的0）

| <code><nowiki>{{CURRENTMONTH1}}</nowiki></code>

| {{CURRENTMONTH1}}

| 月（无前导的0）

|-

| <code><nowiki>{{CURRENTMONTHNAME}}</nowiki></code>

| 月份名称

| <code><nowiki>{{CURRENTMONTHNAMEGEN}}</nowiki></code>

| 月份（属格）

| <code><nowiki>{{CURRENTMONTHABBREV}}</nowiki></code>

| 月份（缩写）

! colspan="3" style="background-color: #DDDDDD;" | 日

{{Table-AnchorRow|CURRENTDAY|CURRENTDAY2|CURRENTDOW|CURRENTDAYNAME}}

| <code><nowiki>{{CURRENTDAY}}</nowiki></code>

| 今天是几日（不补齐）

| <code><nowiki>{{CURRENTDAY2}}</nowiki></code>

| 今天是几日（以0补齐）

| <code><nowiki>{{CURRENTDOW}}</nowiki></code>

| 周内一日（无填充），0（即星期日）到6（即星期六）

| <code><nowiki>{{CURRENTDAYNAME}}</nowiki></code>

| 周内一日（名称）

! colspan="3" style="background-color: #DDDDDD;" | 时间

{{Table-AnchorRow|CURRENTTIME|CURRENTHOUR}}

| <code><nowiki>{{CURRENTTIME}}</nowiki></code>

| 时间（24小时制HH:mm的格式）

| <code><nowiki>{{CURRENTHOUR}}</nowiki></code>

| 时间（24小时制含前導0的数字）

! colspan="3" style="background-color: #DDDDDD;" | 其他

{{Table-AnchorRow|CURRENTWEEK|CURRENTTIMESTAMP}}

| <code><nowiki>{{CURRENTWEEK}}</nowiki></code>

| 第几周（数字）

| <code><nowiki>{{CURRENTTIMESTAMP}}</nowiki></code>

{{memo|1={{tlx|CURRENTDATE}}未必是一个魔术字，但可能是一个[[Help:模板|模板]]。}}

如下变量和上列变量功能相同，但是使用的是所在服务器的时间或者<code>$wgLocaltimezone</code>。

* <code><nowiki>{{LOCALYEAR}}</nowiki></code>

* <code><nowiki>{{LOCALMONTH}}</nowiki></code>

* <code><nowiki>{{LOCALMONTH1}}</nowiki></code>

* <code><nowiki>{{LOCALMONTHNAME}}</nowiki></code>

* <code><nowiki>{{LOCALMONTHNAMEGEN}}</nowiki></code>

* <code><nowiki>{{LOCALMONTHABBREV}}</nowiki></code>

* <code><nowiki>{{LOCALDAY}}</nowiki></code>

* <code><nowiki>{{LOCALDAY2}}</nowiki></code>

* <code><nowiki>{{LOCALDOW}}</nowiki></code>

* <code><nowiki>{{LOCALDAYNAME}}</nowiki></code>

* <code><nowiki>{{LOCALTIME}}</nowiki></code>

* <code><nowiki>{{LOCALHOUR}}</nowiki></code>

* <code><nowiki>{{LOCALWEEK}}</nowiki></code>

* <code><nowiki>{{LOCALTIMESTAMP}}</nowiki></code>

'''如果需要更详尽的时间格式，或是在輸出目前年份和星期時更好的遵守[[ISO 8601|ISO-8601]]，您可以使用<code><nowiki>#</nowiki>time}}</code>解析器函数。'''

<span id="Technical_metadata"></span>

! width="10%" | 变量

! width="15%" | 输出

! 描述

! width="10%" | 备注

{{Table-AnchorRow|Site}}

! colspan="4" style="background-color: #DDDDDD;" | 站点

{{Table-AnchorRow|SITENAME}}

| <code><nowiki>{{SITENAME}}</nowiki></code>

| 网站的名称（<code>$wgSitename</code>）。

|

{{Table-AnchorRow|SERVER}}

| <code><nowiki>{{SERVER}}</nowiki></code>

| 域名[[URL|URL]]（<code>$wgServer</code>）.

|

{{Table-AnchorRow|SERVERNAME}}

| <code><nowiki>{{SERVERNAME}}</nowiki></code>

| 子域名和域名（自版本1.17后不再取决于<code>$wgServerName</code>）。

|

{{Table-AnchorRow|DIRMARK|DIRECTIONMARK}}

| <code><nowiki>{{DIRMARK}}</nowiki></code> <br>

<code><nowiki>{{DIRECTIONMARK}}</nowiki></code>

| {{DIRMARK}} <br>

{{DIRECTIONMARK}}

| 输出这个wiki默认语言所使用的[[Unicode|Unicode]]文本方向控制字符（从左到右书写的语言使用<code>&amp;lrm;</code>，反之使用<code>&amp;rlm;</code>），这在多方向文本中很有用。它取决于页面语言。

|

{{Table-AnchorRow|SCRIPTPATH}}

| <code><nowiki>{{SCRIPTPATH}}</nowiki></code>

| 脚本相对路径（<code>$wgScriptPath</code>）。

|

{{Table-AnchorRow|STYLEPATH}}

| <code><nowiki>{{STYLEPATH}}</nowiki></code>

| {{STYLEPATH}}

| 样式相对路径（<code>$wgStylePath</code>）。

|

{{Table-AnchorRow|CURRENTVERSION}}

|-

| <code><nowiki>{{CURRENTVERSION}}</nowiki></code>

| 此站点的MediaWiki版本。

|

{{Table-AnchorRow|CONTENTLANGUAGE|CONTENTLANG}}

| <code><nowiki>{{CONTENTLANGUAGE}}</nowiki></code> <br>

<code><nowiki>{{CONTENTLANG}}</nowiki></code>

| {{CONTENTLANGUAGE}} <br>

{{CONTENTLANG}}

| 默认界面语言（<code>$wgLanguageCode</code>）。

|

! colspan="4" style="background-color: #DDDDDD;" | 页面

{{Table-AnchorRow|Page|PAGEID|PROTECTIONLEVEL|PROTECTIONEXPIRY|CASCADINGSOURCES}}

| <code><nowiki>{{PAGEID}}</nowiki></code>

| {{PAGEID}}

| 返回页面编号。

|

{{Table-AnchorRow|PAGELANGUAGE}}

| <code><nowiki>{{PAGELANGUAGE}}</nowiki></code><br><!--

--><code><nowiki>{{#language:{{PAGELANGUAGE}}}}</nowiki></code>

| {{PAGELANGUAGE}}<br><!--

-->{{#language:{{PAGELANGUAGE}}}}

| 返回当前页面的语言。此变量返回的语言代码可使用<code><nowiki>{{</nowiki>[[##language|#language]]<nowiki>:...}}</nowiki></code>转换为语言名。

|

| <code><nowiki>{{PROTECTIONLEVEL:</nowiki>'''操作'''<nowiki>}}</nowiki></code>

| <!-- Leave this empty. -->

| 输出当前页面对于特定行为（比如edit，move）的保护级别（autoconfirm或sysop等）。若未保护则返回空字符串。

|

|-

| <code><nowiki>{{PROTECTIONEXPIRY:</nowiki>'''动作'''<nowiki>}}</nowiki></code>

| <!-- Leave this empty. -->

| 根据给出的动作（如edit、move），返回当前页面的保护信息（例如：时间戳“20160418155030”，或“infinity”） 如果未被保护，则会返回"infinity"。

|

|- style="background:#FED;"

| <code><nowiki>{{CASCADINGSOURCES}}</nowiki></code>

| <!-- Leave this empty. -->

| '''[高开销]''' 返回当前页面上的任意连锁保护操作来源。除非存在自我嵌入，否则页面将不会返回其各自标题。

|

|-

! colspan="4" style="background-color: #DDDDDD;" | 最近一次编辑版本号

{{Table-AnchorRow|revision|REVISIONID|REVISIONDAY|REVISIONDAY2|REVISIONMONTH|REVISIONMONTH1|REVISIONYEAR|REVISIONTIMESTAMP|REVISIONUSER}}

|-

| <code><nowiki>{{REVISIONID}}</nowiki></code>

| {{REVISIONID}}

| 唯一的版本ID。 在預覽中為空，因此能用來顯示僅限於預覽時的錯誤訊息。可能在吝嗇模式（<code>$wgMiserMode</code>）中被停用。

|

|-

| <code><nowiki>{{REVISIONDAY}}</nowiki></code>

| {{REVISIONDAY}}

| 最近一次编辑的日期（无前导0）。

|

|-

| <code><nowiki>{{REVISIONDAY2}}</nowiki></code>

| {{REVISIONDAY2}}

| 最近一次编辑的日期（前导0）

|

|-

| <code><nowiki>{{REVISIONMONTH}}</nowiki></code>

| {{REVISIONMONTH}}

| 最近一次编辑的月份（有前导0）。

|

|-

| <code><nowiki>{{REVISIONMONTH1}}</nowiki></code>

| {{REVISIONMONTH1}}

| 最近一次编辑的月份（没有前导0）。

|

|-

| <code><nowiki>{{REVISIONYEAR}}</nowiki></code>

| {{REVISIONYEAR}}

| 最近一次编辑的年份

|

|-

| <code><nowiki>{{REVISIONTIMESTAMP}}</nowiki></code>

| {{REVISIONTIMESTAMP}}

| 最近一次编辑的时间戳。

|

|-

| <code><nowiki>{{REVISIONUSER}}</nowiki></code>

| {{REVISIONUSER}}

| 最近一个对指定页面作出编辑的用户，或者当前正在对其编辑进行预览的用户。

|

|-

| <code><nowiki>{{REVISIONSIZE}}</nowiki></code>

| {{REVISIONSIZE}}

| 当前版本页面的大小（wikitext）。

|

|-

! colspan="4" style="background-color: #DDDDDD;" | 影响页面内容

{{Table-AnchorRow|DISPLAYTITLE|DisplayTitle}}

|-

| <code><nowiki>{{DISPLAYTITLE:</nowiki>'''标题'''<nowiki>}}</nowiki></code> <br><code><nowiki>{{DISPLAYTITLE:</nowiki>'''标题'''<nowiki>|noerror}}</nowiki></code> <br><code><nowiki>{{DISPLAYTITLE:</nowiki>'''标题'''<nowiki>|noreplace}}</nowiki></code>

| 设置当前页面标题的显示格式。变量值须与标题等值：只允许对标题的特定部分（不是全部标题）的大小写变化和用下划线替换替换空格（这个设定可以通过<code>$wgRestrictDisplayTitle</code>改变）。可以通过<code>$wgAllowDisplayTitle</code>将其启用或禁用；在1.10+前默认禁用，之后的版本中默认启用。

可以使用第二个参数：“noerror”关闭使用多个本魔术字时导致错误消息提示。或“noreplace”如果<code>displaytitle</code>在前文已经设置，则关闭使用多个本魔术字时导致错误消息提示令<code>displaytitle</code>失效。

|

（以无错误提示、不替换为目的）

{{Table-AnchorRow|DEFAULTSORT|DEFAULTCATEGORYSORT|DEFAULTSORTKEY|Defaultsort}}

| <code><nowiki>{{DEFAULTSORT:</nowiki>'''排序关键字'''<nowiki>}}</nowiki></code> <br><code><nowiki>{{DEFAULTSORTKEY:</nowiki>'''排序关键字'''<nowiki>}}</nowiki></code> <br><code><nowiki>{{DEFAULTCATEGORYSORT:</nowiki>'''排序关键字'''<nowiki>}}</nowiki></code> <br><code><nowiki>{{DEFAULTSORT:</nowiki>'''排序关键字'''<nowiki>|noerror}}</nowiki></code> <br><code><nowiki>{{DEFAULTSORT:</nowiki>'''排序关键字'''<nowiki>|noreplace}}</nowiki></code>

| 在分类页面上使用，用来设置默认[[Help:分类|在分类中排序关键字]]。 例如当你将<code><nowiki>{{DEFAULTSORT:</nowiki>Smith, John<nowiki>}}</nowiki></code>放到页面[[John Smith]]的结尾，该页面在分类页面上的列表中将默认排到“S”项下。 可以使用第二个参数：“noerror”关闭使用多个本魔术字时导致错误消息提示。或“noreplace”如果<code>defaultsort</code>在前文已经设置，则关闭使用多个本魔术字时导致错误消息提示，令<code>defaultsort</code>失效。

|

（以无错误提示、不替换为目的）

<span id="Statistics"></span>

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

对于PAGESINCATEGORY等需要参数的变量则使用“|R”（例如<code><nowiki>{{PAGESINCategory:求闻百科分类}}</nowiki></code>和<code><nowiki>{{PAGESINCategory:求闻百科分类|R}}</nowiki></code>及<code><nowiki>{{PAGESINCategory:求闻百科分类|subcats}}</nowiki></code>和<code><nowiki>{{PAGESINCategory:求闻百科分类|subcats|R}}</nowiki></code>）。

也适用于上述{{tmpl|0=<code>{{((}}PAGESIZE:$1{{))}}</code>|'''页面名称'''}}。

返回数字的魔术字数字格式取决于内容语言的设定，取决于页面内容语言。

! width="10%" | 变量

! width="10%" | 输出

! 描述

{{Table-AnchorRow|NUMBEROFPAGES}}

| <code><nowiki>{{NUMBEROFPAGES}}</nowiki></code>

| 页面数量

{{Table-AnchorRow|NUMBEROFARTICLES}}

| <code><nowiki>{{NUMBEROFARTICLES}}</nowiki></code>

| 在内容名字空间中，作为条目的页面个数。

{{Table-AnchorRow|NUMBEROFFILES}}

| <code><nowiki>{{NUMBEROFFILES}}</nowiki></code>

| 上传文件的个数。

{{Table-AnchorRow|NUMBEROFEDITS}}

| <code><nowiki>{{NUMBEROFEDITS}}</nowiki></code>

| 编辑的数量

{{Table-AnchorRow|NUMBEROFVIEWS}}

| <code><nowiki>{{NUMBEROFVIEWS}}</nowiki></code>

|

| 页面浏览次数。通常对使用缓存的wiki无效。

{{Table-AnchorRow|NUMBEROFUSERS}}

|-

| <code><nowiki>{{NUMBEROFUSERS}}</nowiki></code>

| 注册用户数量

{{Table-AnchorRow|NUMBEROFADMINS}}

| <code><nowiki>{{NUMBEROFADMINS}}</nowiki></code>

| '''管理员（sysop）'''组的用户数。

{{Table-AnchorRow|NUMBEROFACTIVEUSERS}}

| <code><nowiki>{{NUMBEROFACTIVEUSERS}}</nowiki></code>

| 活跃用户总数，其标准与[[Special:Statistics]]中的标准相同。

{{Table-AnchorRow|PAGESINCATEGORY|PAGESINCAT}}

|- style="background:#FED;"

| <code><nowiki>{{PAGESINCATEGORY:</nowiki>'''分类名称'''<nowiki>}}</nowiki></code> <br><code><nowiki>{{PAGESINCAT:</nowiki>'''分类名称'''<nowiki>}}</nowiki></code>

| {{PAGESINCATEGORY:求闻百科分类}} <br>{{PAGESINCAT:Help}}

| '''[高开销]''' 指定[[Help:分类|分类]]中的页面总数（包括子类和文件）。<small>（[[:Category:求闻百科分类]] 在此用于演示）</small>

|- style="background:#FED;"

| <code><nowiki>{{PAGESINCATEGORY:</nowiki>'''分类名称'''<nowiki>|all}}</nowiki></code> <br><code><nowiki>{{PAGESINCATEGORY:</nowiki>'''分类名称'''<nowiki>|pages}}</nowiki></code> <br><code><nowiki>{{PAGESINCATEGORY:</nowiki>'''分类名称'''<nowiki>|subcats}}</nowiki></code> <br><code><nowiki>{{PAGESINCATEGORY:</nowiki>'''分类名称'''<nowiki>|files}}</nowiki></code>

| {{PAGESINCATEGORY:求闻百科分类|all}} <br>{{PAGESINCATEGORY:求闻百科分类|pages}} <br>{{PAGESINCATEGORY:求闻百科分类|subcats}} <br>{{PAGESINCATEGORY:求闻百科分类|files}}

| '''[高开销]''' 返回指定[[Help:分类|分类]]的：

*所有页面数

*所有非分类页和非文件页数

*所有子分类页数

*所有文件页数

<small>（[[:Category:求闻百科分类]] 在此用于演示）</small>

{{Table-AnchorRow|NUMBERINGROUP|NUMINGROUP}}

| <code><nowiki>{{NUMBERINGROUP:</nowiki>'''用户组'''<nowiki>}}</nowiki></code> <br><code><nowiki>{{NUMINGROUP:</nowiki>'''用户组'''<nowiki>}}</nowiki></code>

| {{NUMBERINGROUP:sysop}} <br>{{NUMINGROUP:sysop}}

| 特定用户组中的用户总数 <small>(sysop用于演示)</small>

{{Table-AnchorRow|PAGESINNS|PAGESINNAMESPACE}}

|- style="background:#FED;"

| <code><nowiki>{{PAGESINNS:</nowiki>'''索引编号'''<nowiki>}}</nowiki></code> <br><code><nowiki>{{PAGESINNAMESPACE:</nowiki>'''索引编号'''<nowiki>}}</nowiki></code>

| '''未启用'''

| '''[高开销]''' 指定[[Help:NS|名字空间]]中的页面总数。（将“索引编号”替换成相关[[Help:NS|名字空间编号]]）。 例如<code><nowiki>{{PAGESINNAMESPACE:</nowiki>'''14'''<nowiki>}}</nowiki></code>返回分类页面总数。<code><nowiki>{{PAGESINNS:0}}</nowiki></code>与<code><nowiki>{{NUMBEROFARTICLES}}</nowiki></code>不同之处在于包括重定向页面和消除歧义页面。 默认禁用，可以通过<code>$wgAllowSlowParserFunctions</code>设置启用。

{{Anchor|Page-names}}

<span id="Page_names"></span>

=== 页面名称 ===

{| class="wikitable"

! width="10%" | 变量

! width="10%" | 对于当前页面

! 描述

{{Table-AnchorRow|FULLPAGENAME|fullpagename}}

| <code><nowiki>{{FULLPAGENAME}}</nowiki></code>

| 命名空间与完整页面标题（包括子页面级别）。

{{Table-AnchorRow|PAGENAME|pagename}}

| <code><nowiki>{{PAGENAME}}</nowiki></code>

| 不包含名字空间的完整页面标题（包括子页面级别）。

{{Table-AnchorRow|BASEPAGENAME|basepagename}}

| <code><nowiki>{{BASEPAGENAME}}</nowiki></code>

| 页面标题，不包括当前[[Help:子页面|子页面标题]]及命名空间。 在<code>Help:Title/Foo/Bar</code>頁面返回<code>Title/Foo</code>。

{{Table-AnchorRow|ROOTPAGENAME|rootpagename}}

| <code><nowiki>{{ROOTPAGENAME}}</nowiki></code>

| {{ROOTPAGENAME}}

| 获得当前页面的根页名。 在<code>Help:Title/Foo/Bar</code>頁面返回<code>Title</code>。

{{Table-AnchorRow|SUBPAGENAME|subpagename}}

|-

| <code><nowiki>{{SUBPAGENAME}}</nowiki></code>

| [[Help:子页面|子頁面]]標題。 在<code>Help:Title/Foo/Bar</code>頁面返回<code>Bar</code>。

如果子頁面不存在將會回傳<code><nowiki>{{PAGENAME}}</nowiki></code>的值。

如果需要使用更多匹配的话，请使用[[Help:解析器函数|解析器函数擴充功能]]的<code><nowiki>{{</nowiki>[[Help:解析器函数#.23titleparts|#titleparts:]]<nowiki>}}</nowiki></code>。

{{Table-AnchorRow|SUBJECTPAGENAME|ARTICLEPAGENAME|subjectpagename|articlepagename}}

| <code><nowiki>{{SUBJECTPAGENAME}}</nowiki></code> <br><code><nowiki>{{ARTICLEPAGENAME}}</nowiki></code>

| {{SUBJECTPAGENAME}}<br>{{ARTICLEPAGENAME}}

| 获得该页面的完整页面名。对讨论页十分有用。

{{Table-AnchorRow|TALKPAGENAME|talkpagename}}

| <code><nowiki>{{TALKPAGENAME}}</nowiki></code>

| 关联讨论页的完整页面名称

这些变量不受 <code><nowiki>{{DISPLAYTITLE:xxxx}}</nowiki></code> 影响，它们都会按原来的页面标题计算返回值。

<code><nowiki>{{BASEPAGENAME}}</nowiki></code>和<code><nowiki>{{SUBPAGENAME}}</nowiki></code>这两个魔术字只在启用了子页面模式的名字空间才生效。关于启用子页面模式请看<code>$wgNamespacesWithSubpages</code>。

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

* {{demo inline|<nowiki>{{PAGENAME:Template:Main Page}}</nowiki>}}

{{Warning|1=

如果页面标题包含存在<code>.</code>”或“<code>..</code>”的任意部分，魔术字什么都不返回。

: {{demo inline|<nowiki>{{PAGENAME:one/./three}}</nowiki>}}. <small>不会返回任何东西。</small>

}}

{{Warning|1=页面标题如果包括特定字符，例如：单引号<code>'</code>、星号<code>*</code>, 会导致以上魔术字会有不正常的处理结果，如：<code><nowiki>{{PAGESINCATEGORY:{{PAGENAME}}}}</nowiki></code>。一种简单的修复方法是使用[[Help:解析器函数|解析器函数扩展]]的<code><nowiki>{{</nowiki>[[Help:解析器函数#.23titleparts|#titleparts:]]<nowiki>}}</nowiki></code>来处理标题。

}}

<span id="URL_encoded_page_names"></span>

==== URL 編碼後的頁面名稱 ====

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

{{anchor|FULPAGENAMEE|PAGENAMEE|BASEPAGENAMEE|SUBPAGENAMEE|SUBJECTPAGENAMEE|ARTICLEPAGENAMEE|TALKPAGENAMEE|ROOTPAGENAMEE}}

* <code><nowiki>{{FULLPAGENAMEE}}</nowiki></code>

* <code><nowiki>{{PAGENAMEE}}</nowiki></code>

* <code><nowiki>{{BASEPAGENAMEE}}</nowiki></code>

* <code><nowiki>{{SUBPAGENAMEE}}</nowiki></code>

* <code><nowiki>{{SUBJECTPAGENAMEE}}</nowiki></code>

* <code><nowiki>{{ARTICLEPAGENAMEE}}</nowiki></code>

* <code><nowiki>{{TALKPAGENAMEE}}</nowiki></code>

* <code><nowiki>{{ROOTPAGENAMEE}}</nowiki></code>

注意<code><nowiki>{{PAGENAME:...}}</nowiki></code>、<code><nowiki>{{PAGENAMEE:...}}</nowiki></code>和<code><nowiki>{{urlencode:...}}</nowiki></code>有不同的实现方式。

<span id="Namespaces"></span>

{| class="wikitable"

! 变量

! 输出

! 描述

! 版本

|- id="NAMESPACE"

| <code><nowiki>{{NAMESPACE}}</nowiki></code>

| 页面的命名空间的名称 （除去主空间）

|

|- id="NAMESPACENUMBER"

| <code><nowiki>{{NAMESPACENUMBER}}</nowiki></code>

| {{NAMESPACENUMBER}}

| 页面所在名字空间的ID

|

|- id="SUBJECTSPACE"

| <code><nowiki>{{SUBJECTSPACE}}</nowiki></code> <br><code><nowiki>{{ARTICLESPACE}}</nowiki></code>

| {{SUBJECTSPACE}} <br>{{ARTICLESPACE}}

| 相关联的内容名字空间的名称

|

|- id="TALKSPACE"

| <code><nowiki>{{TALKSPACE}}</nowiki></code>

| 相关联的讨论名字空间的名称

|

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

* <code><nowiki>{{NAMESPACEE}}</nowiki></code>

* <code><nowiki>{{SUBJECTSPACEE}}</nowiki></code>

* <code><nowiki>{{ARTICLESPACEE}}</nowiki></code>

* <code><nowiki>{{TALKSPACEE}}</nowiki></code>

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

* <code><nowiki>{{NAMESPACENUMBER:MediaWiki}}</nowiki></code> &rarr; '''{{NAMESPACENUMBER:MediaWiki}}'''

* <code><nowiki>{{NAMESPACE:MediaWiki}}</nowiki></code> &rarr; '''{{NAMESPACE:MediaWiki}} '''(Pages in main space will return empty)'''

* <code><nowiki>{{NAMESPACE:Template:Main Page}}</nowiki></code> &rarr; '''{{NAMESPACE:Template:Main Page}}'''

* <code><nowiki>{{SUBJECTSPACE:Template:Main Page}}</nowiki></code> &rarr; '''{{SUBJECTSPACE:Template:Main Page}}'''

* <code><nowiki>{{ARTICLESPACE:Template:Main Page}}</nowiki></code> &rarr; '''{{ARTICLESPACE:Template:Main Page}}'''

* <code><nowiki>{{TALKSPACE:Template:Main Page}}</nowiki></code> &rarr; '''{{TALKSPACE:Template:Main Page}}'''

参数必须不是一个名字空间名称：

* <code><nowiki>{{SUBJECTSPACE:Help talk}}</nowiki></code> &rarr; '''{{SUBJECTSPACE:Help talk}}<!-- empty -->&nbsp;''' ('''Empty''')

<span id="Other"></span>

=== 其他 ===

! 变量

! 输出

! 描述

{{Table-AnchorRow|PIPE|Pipe|pipe|&#x7C;|.7C|!|.21|&#x7B;&#x7B;!&#x7D;&#x7D;|.7B.7B.21.7D.7D}}

| <code><nowiki>{{!}}</nowiki></code>

|style="text-align:center;"| {{!}}

| 用于在模板或者是表格内插入管道符号。在被添加为魔术字之前，许多wiki通过创建[[Template:!]]（内容为<code>{{!}}</code>）来实现。

有关更多说明，请参见[[Help:解析器函数#Escaping pipe characters in tables|幫助:扩展:解析器函數#在表格中逸出的管道符]]

| <code><nowiki>{{=}}</nowiki></code>

|style="text-align:center;"| {{=}}

| 用于在模板参数或表格的单元格内容中插入等于号。 在被添加为魔术字之前，许多wiki通过创建[[Template:=]]（内容为<code>{{=}}</code>）来实现。

有关更多说明，请参见[[Help:解析器函数#Raw equal signs|幫助:扩展:解析器函數#原始等号]]。

<span id="Parser_functions"></span>

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

此页面只描述MediaWiki软件中重要的解析器函数。其他MediaWiki软件可能添加的解析器函数包括ParserFunctions等。

<span id="Technical_metadata_of_another_page"></span>

=== 另一页面的技术元数据 ===

{| class="wikitable"

|-

! width="15%" | 解析器函数

! width="10%" | 输出

! 描述

{{Table-AnchorRow|PAGEID:}}

|- style="background: #FED;"

| <code><nowiki>{{PAGEID: </nowiki>'''页面名称'''<nowiki> }}</nowiki></code>

| {{PAGEID: Qiuwen:首页 }}

| '''[高开销]''' 返回指定页面*的页面标识符。

{{Table-AnchorRow|PAGESIZE|PAGESIZE:}}

|- style="background: #FED;"

| <code><nowiki>{{PAGESIZE:</nowiki>'''页面名称'''<nowiki>}}</nowiki></code> <br><code><nowiki>{{PAGESIZE: </nowiki>'''页面名称'''<nowiki> |R}}</nowiki></code>

| {{PAGESIZE: Help:Magic_words }} <br>{{PAGESIZE: Help:Magic_words |R}}

| '''[高开销]''' 返回特定页面的字节大小。使用“<code><nowiki>|R</nowiki></code>”获取原始（未处理）数值。

{{Table-AnchorRow|PROTECTIONLEVEL:}}

|- style="background: #FED;"

| <code><nowiki>{{</nowiki>PROTECTIONLEVEL:'''操作''' &#124; '''页面名称'''}}</code>

| {{PROTECTIONLEVEL: edit | Qiuwen:首页 }}

| '''[高开销]''' 输出当前页面对于特定行为（比如edit，move）的保护级别（autoconfirm或sysop等）。若未保护则返回空字符串。

{{Table-AnchorRow|PROTECTIONEXPIRY:}}

|- style="background: #FED;"

| <code><nowiki>{{</nowiki>PROTECTIONEXPIRY: '''操作''' &#124; '''页面名称'''}}</code>

| {{PROTECTIONEXPIRY: edit | Qiuwen:首页 }}

| '''[高开销]''' 根据给出的动作（如edit、move），返回当前页面的保护信息（例如：时间戳“20160418155030”，或“infinity（无限期）”） 如果未被保护，则会返回"infinity（无限期）"。

{{Table-AnchorRow|CASCADINGSOURCES:}}

|- style="background: #FED;"

| <code><nowiki>{{CASCADINGSOURCES:</nowiki> '''page name'''<nowiki>}}</nowiki></code>

| <!-- Leave this empty. -->

| '''[高开销]''' 返回在特定页面上任意连锁保护的来源。页面将不会返回其本身标题，除非页面有自我嵌入行为。

{{Table-AnchorRow|REVISIONID:}}

|- style="background: #FED;"

| <code><nowiki>{{REVISIONID: </nowiki>'''页面名称'''<nowiki> }}</nowiki></code>

| {{REVISIONID: Qiuwen:首页 }}

| '''[高开销]''' 当前页面的最新更改的ID。

{{Table-AnchorRow|REVISIONDAY:}}

|- style="background: #FED;"

| <code><nowiki>{{REVISIONDAY: </nowiki>'''页面名称'''<nowiki> }}</nowiki></code>

| {{REVISIONDAY: Qiuwen:首页 }}

| '''[高开销]''' 指定页面的最新更改的天* （未补全的数字）。

{{Table-AnchorRow|REVISIONDAY2:}}

|- style="background: #FED;"

| <code><nowiki>{{REVISIONDAY2: </nowiki>'''页面名称'''<nowiki> }}</nowiki></code>

| {{REVISIONDAY2: Qiuwen:首页 }}

| '''[高开销]''' 指定页面的最新更改的天* （以0补全的数字）。

{{Table-AnchorRow|REVISIONMONTH:}}

|- style="background: #FED;"

| <code><nowiki>{{REVISIONMONTH: </nowiki>'''页面名称'''<nowiki> }}</nowiki></code>

| {{REVISIONMONTH: Qiuwen:首页 }}

| '''[高开销]''' 指定页面的最新修改的月* (以0补全的数字)。

{{Table-AnchorRow|REVISIONMONTH1:}}

|- style="background: #FED;"

| <code><nowiki>{{REVISIONMONTH1: </nowiki>'''页面名称'''<nowiki> }}</nowiki></code>

| {{REVISIONMONTH1: Qiuwen:首页 }}

| '''[高开销]''' 指定页面的最新修改的月* (未补全的数字)。

{{Table-AnchorRow|REVISIONYEAR:}}

|- style="background: #FED;"

| <code><nowiki>{{REVISIONYEAR: </nowiki>'''页面名称'''<nowiki> }}</nowiki></code>

| {{REVISIONYEAR: Qiuwen:首页 }}

| '''[高开销]''' 指定页面的最新修改的年*。

{{Table-AnchorRow|REVISIONTIMESTAMP:}}

|- style="background: #FED;"

| <code><nowiki>{{REVISIONTIMESTAMP: </nowiki>'''页面名称'''<nowiki> }}</nowiki></code>

| {{REVISIONTIMESTAMP: Qiuwen:首页 }}

| '''[高开销]''' 指定页面的最新修改的时间截*。

{{Table-AnchorRow|REVISIONUSER:}}

|- style="background: #FED;"

| <code><nowiki>{{REVISIONUSER: </nowiki>'''页面名称'''<nowiki> }}</nowiki></code>

| {{REVISIONUSER: Qiuwen:首页 }}

| '''[高开销]''' 指定页面的最新修改的用户名*。

|-

| colspan="3" | *当提供的参数等于当前解析器标题，在预览时以及在替换使用时解析器函数将产生上一版本，在用于页面创建时，这包括空字符串，但使用来自当前版本页面浏览的值，包括浏览旧版本。这种情况下它并非高开销函数解析器。

|}

<span id="URL_data"></span>

! scope="col" | 解析器函数

! scope="col" | 输入 → 输出

! scope="col" | 描述

{{Table-AnchorRow|localurl|LOCALURL}}

| <code><nowiki>{{localurl:</nowiki>'''页面名称'''<nowiki>}}</nowiki></code> <br><code><nowiki>{{localurl:</nowiki>'''页面名称'''<br><nowiki>|</nowiki>'''请求参数'''<nowiki>}}</nowiki></code>

| <code><nowiki>{{localurl:MediaWiki}}</nowiki></code><br>→ {{localurl:MediaWiki}} <br><code><nowiki>{{localurl:MediaWiki|printable=yes}}</nowiki></code><br>→ {{localurl:MediaWiki|printable=yes}}

| 至標題的相對路徑。

{{Table-AnchorRow|fullurl|FULLURL}}

| <code><nowiki>{{fullurl:</nowiki>'''页面名称'''<nowiki>}}</nowiki></code> <br><code><nowiki>{{fullurl:</nowiki>'''页面名称'''<br><nowiki>|</nowiki>'''请求参数'''<nowiki>}}</nowiki></code> <br><code><nowiki>{{fullurl:</nowiki>'''跨站前缀:另一站点上的页面名称'''<br><nowiki>|</nowiki>'''请求参数'''<nowiki>}}</nowiki></code>

| <code><nowiki>{{fullurl:Category:Top level}}</nowiki></code><br>→ {{fullurl:Category:Top level}} <br>

<code><nowiki>{{fullurl:Category:Top level|action=edit}}</nowiki></code><br>→ {{fullurl:Category:Top level|action=edit}}<br>

<code><nowiki>{{fullurl:s:Electra|action=edit}}</nowiki></code><br>→ {{fullurl:s:Electra|action=edit}}<br>

<code><nowiki>{{fullurl:s:es:Electra|action=edit}}</nowiki></code><br>→ {{fullurl:s:es:Electra|action=edit}}

| 至标题的协议相对路径，基於本地wiki的<code>$wgServer</code>設定（且不一定會以<code>http(s)://</code>開頭）。这也将解决[[Help:跨wiki|跨wiki]]前缀。'''注意：'''未加括号的（单一）协议相对链接不会自动链接。

{{Table-AnchorRow|canonicalurl|CANONICALURL}}

| <code><nowiki>{{canonicalurl:</nowiki>'''页面名称'''<nowiki>}}</nowiki></code> <br><code><nowiki>{{canonicalurl:</nowiki>'''页面名称'''<br><nowiki>|</nowiki>'''请求参数'''<nowiki>}}</nowiki></code> <br><code><nowiki>{{canonicalurl:</nowiki>'''跨站前缀:另一站点上的页面名称'''<br><nowiki>|</nowiki>'''请求参数'''<nowiki>}}</nowiki></code>

| <code><nowiki>{{canonicalurl:Category:Top level}}</nowiki></code><br>→ {{canonicalurl:Category:Top level}} <br>

<code><nowiki>{{canonicalurl:Category:Top level|action=edit}}</nowiki></code><br>→ {{canonicalurl:Category:Top level|action=edit}}

<code><nowiki>{{canonicalurl:w:Category:Top level|action=edit}}</nowiki></code><br>→

{{canonicalurl:w:Category:Top level|action=edit}}

| 至标题的绝对路径，使用规范URL。这也将解决[[Help:跨wiki|跨wiki]]前缀。

{{Table-AnchorRow|filepath|FILEPATH}}

| <code><nowiki>{{filepath:</nowiki>'''文件名称'''<nowiki>}}</nowiki></code> <br><code><nowiki>{{filepath:</nowiki>'''文件名称'''<nowiki>|nowiki}}</nowiki></code> <br><code><nowiki>{{filepath:</nowiki>'''文件名称'''<nowiki>|</nowiki>'''缩略图大小'''<nowiki>}}</nowiki></code>

| <code><nowiki>{{filepath:Qiuwen.svg}}</nowiki></code><br>→ {{filepath:Qiuwen.svg}} <br>

<code><nowiki>{{filepath:Qiuwen.svg|nowiki}}</nowiki></code><br>→ {{filepath:Qiuwen.svg|nowiki}} <br>

<code><nowiki>{{filepath:Qiuwen.svg|300}}</nowiki></code><br>→ {{filepath:Qiuwen.svg|300}} <br><br>

参数<code>nowiki</code>通常会删除文件路径周围的链接（在本例中看不到）。

| 媒体文件的完整大小或缩略图的协议相对路径。

{{Table-AnchorRow|urlencode|URLENCODE}}

| <code><nowiki>{{urlencode:</nowiki>'''字符串'''<nowiki>}}</nowiki></code> 或 <br><code><nowiki>{{urlencode:</nowiki>'''字符串'''<nowiki>|QUERY}}</nowiki></code> <br><code><nowiki>{{urlencode:</nowiki>'''字符串'''<nowiki>|WIKI}}</nowiki></code> <br><code><nowiki>{{urlencode:</nowiki>'''字符串'''<nowiki>|PATH}}</nowiki></code>

| <code><nowiki>{{urlencode:x:y/z á é}}</nowiki></code> 或 <br><code><nowiki>{{urlencode:x:y/z á é|QUERY}}</nowiki></code><br>→ {{urlencode:x:y/z á é}} <br><code><nowiki>{{urlencode:x:y/z á é|WIKI}}</nowiki></code><br>→ {{urlencode:x:y/z á é|WIKI}} <br><code><nowiki>{{urlencode:x:y/z á é|PATH}}</nowiki></code><br>→ {{urlencode:x:y/z á é|PATH}}

请注意，在1.17中，默认值从<code>|WIKI</code>更改为<code>|QUERY</code>，这可能会破坏依赖此功能的模板。

| 编码的输入用于URL。请注意，没有像过时的StringFunctions中那样的urldecode函数<br><table class="wikitable"><caption>字符編碼</caption><tr><th>代码</th><th>空格</th></tr><tr><td>&nbsp;'''none'''</td><td><samp>&nbsp;+&nbsp;</samp></td></tr><tr><td><kbd>QUERY</kbd></td><td><samp>&nbsp;+&nbsp;</samp></td></tr><tr><td><kbd>&nbsp;WIKI</kbd></td><td><samp>&nbsp;_&nbsp;</samp></td></tr><tr><td><kbd>&nbsp;PATH</kbd></td><td><samp>%20</samp></td></tr></table>

{{Table-AnchorRow|anchorencode|ANCHORENCODE}}

|-

| <code><nowiki>{{anchorencode:</nowiki>'''字符串'''<nowiki>}}</nowiki></code>

| <code><nowiki>{{anchorencode:x y z á é}}</nowiki></code><br>→ {{anchorencode:x y z á é}}

| 编码的输入用于URL部分锚点（在URL中的“#”符号之后）。

{{anchor|ns|Namespaces_2}}

<span id="Namespaces"></span>

<span class="mw-translate-fuzzy"><code><nowiki>{{ns:}}</nowiki></code>使用该索引，规范名称或本地别名返回[[Help:Namespace|名字空间]]的当前本地化名称。因此<code><nowiki>{{ns:6}}</nowiki></code>，<code><nowiki>{{ns:file}}</nowiki></code>和<code><nowiki>{{ns:image}}</nowiki></code>（File名称空间的旧名称）都返回{{ns:6}}。

<code><nowiki>{{nse:}}</nowiki></code>是MediaWiki URL的等效编码。它也是这样，但它用下划线替换空格，使其可用于外部链接。

! colspan="2" width="50%" | 内容名字空间

! rowspan="11" |

! colspan="2" width=%50%" | 讨论名字空间

! 用法

! 输出

! 用法

! 输出

| <code><nowiki>{{ns:-2}}</nowiki></code> / <code><nowiki>{{ns:Media}}</nowiki></code>

| <code><nowiki>{{ns:-1}}</nowiki></code> / <code><nowiki>{{ns:Special}}</nowiki></code>

| {{ns:-1}}<br>'''(no '''talk''' page)'''

| <code><nowiki>{{ns:0}}</nowiki></code> / <code><nowiki>{{ns:}}</nowiki></code>

| <code><nowiki>{{ns:1}}</nowiki></code> / <code><nowiki>{{ns:Talk}}</nowiki></code>

| <code><nowiki>{{ns:2}}</nowiki></code> / <code><nowiki>{{ns:User}}</nowiki></code>

| <code><nowiki>{{ns:3}}</nowiki></code> / <code><nowiki>{{ns:User talk}}</nowiki></code>

| <code><nowiki>{{ns:4}}</nowiki></code> / <code><nowiki>{{ns:Project}}</nowiki></code>

| {{ns:4}} <br>'''Varies between wikis'''

| <code><nowiki>{{ns:5}}</nowiki></code> / <code><nowiki>{{ns:Project talk}}</nowiki></code>

| <code><nowiki>{{ns:6}}</nowiki></code> / <code><nowiki>{{ns:File}}</nowiki></code> or <code><nowiki>{{ns:Image}}</nowiki></code>

| <code><nowiki>{{ns:7}}</nowiki></code> / <code><nowiki>{{ns:File talk}}</nowiki></code> or <code><nowiki>{{ns:Image talk}}</nowiki></code>

| <code><nowiki>{{ns:8}}</nowiki></code> / <code><nowiki>{{ns:MediaWiki}}</nowiki></code>

| <code><nowiki>{{ns:9}}</nowiki></code> / <code><nowiki>{{ns:MediaWiki talk}}</nowiki></code>

| <code><nowiki>{{ns:10}}</nowiki></code> / <code><nowiki>{{ns:Template}}</nowiki></code>

| {{ns:10}}

| <code><nowiki>{{ns:11}}</nowiki></code> / <code><nowiki>{{ns:Template talk}}</nowiki></code>

| <code><nowiki>{{ns:12}}</nowiki></code> / <code><nowiki>{{ns:Help}}</nowiki></code>

| <code><nowiki>{{ns:13}}</nowiki></code> / <code><nowiki>{{ns:Help talk}}</nowiki></code>

| <code><nowiki>{{ns:14}}</nowiki></code> / <code><nowiki>{{ns:Category}}</nowiki></code>

| <code><nowiki>{{ns:15}}</nowiki></code> / <code><nowiki>{{ns:Category talk}}</nowiki></code>

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

<span id="Formatting"></span>

=== 格式化 ===

! 用法

! 输入 → 输出

! 描述

{{Table-AnchorRow|formatnum}}

<code><nowiki>{{formatnum:</nowiki>'''未格式化数字'''<nowiki>}}</nowiki></code> <br>

<code><nowiki>{{formatnum:</nowiki>'''formatnum格式化过的数字'''<nowiki>|R}}</nowiki></code> <br>

<code><nowiki>{{formatnum:</nowiki>'''未格式化数字'''<nowiki>|NOSEP}}</nowiki></code>

|

* 简单：

** <code><nowiki>{{formatnum:987654321.654321}}</nowiki></code> <br> → {{formatnum:987654321.654321}}

** <code><nowiki>{{formatnum:</nowiki>{{formatnum:987654321.654321}}<nowiki>|R}}</nowiki></code> <br> → {{formatnum:{{formatnum:987654321.654321}}|R}}

* 高级：

** <code><nowiki>{{formatnum:{{formatnum:987654321.654321}}|R}}</nowiki></code> <br> → {{formatnum:{{formatnum:987654321.654321}}|R}} （於任意語言）

** <code><nowiki>{{formatnum:00001}}</nowiki></code> <br> → {{formatnum:00001}}

** <code><nowiki>{{formatnum:987654321.654321 |NOSEP}}</nowiki></code> <br> → {{formatnum:987654321.654321 |NOSEP}}

** [[Bengali numerals|孟加拉字母]]的例子：

*** <code><nowiki>{{formatnum:987654321.654321}}</nowiki></code> <br> → ৯৮,৭৬,৫৪,৩২১.৬৫৪৩২১

*** <code><nowiki>{{formatnum:987654321.654321 |NOSEP}}</nowiki></code> <br> → ৯৮৭৬৫৪৩২১.৬৫৪৩২১

*** <code><nowiki>{{formatnum:৯৮,৭৬,৫৪,৩২১.৬৫৪৩২১ |R}}</nowiki></code> <br> → 987654321.654321

----

不被支持的： <br>

<code><nowiki>{{formatnum:{{formatnum:987.654.321}}}}</nowiki></code> <br> → 987 654 321 （例如与意大利语区域设置）

----

错误输入（不可靠输出）的示例，有或没有<code>|R</code>： <br>

<code><nowiki>{{formatnum:987,654.321|R}}</nowiki></code> （这个应该会坏） <br>

<code><nowiki>{{formatnum:987.654,321|R}}</nowiki></code> <br>

<code><nowiki>{{formatnum:987 654,321|R}}</nowiki></code> <br>

<code><nowiki>{{formatnum:987&amp;nbsp;654,321|R}}</nowiki></code>

| 采用未格式化的数字（例如阿拉伯语数字，没有组分隔符和<code>.</code>作为小数分隔符）并将其输出到本地化的数字脚本中，并使用十进制和十进制组分隔符进行格式化，到wiki的默认语言环境。<br>

<code>{{!}}R</code>参数可以用于反转此行为，用于数学运算：这种方法可靠，但只应该用于反向转换与wiki的语言环境相同（原先formatnum会转换到的）的数字。<br>

指定 <code>NOSEP</code>（“无分隔符”）参数会使数位分组分隔符和小数点分隔符不被修改，此时 formatnum 只会在不使用[[印度-阿拉伯数字系统]]的语言中将数字字符进行转换。<code>NOSEP</code> 参数还会防止出现意外的非标准数字分组。

{{warning|1=开头的前导零不会被去除；可以使用 <code><nowiki>{{#expr:00001}}</nowiki></code> 来去除。}}<br>

{{warning|1=如果你没有准确地以需求的数字格式输入，则难以得到任何可靠的输出，尤其是在非英文的wiki上。}}<br>

----

如果你真的需要输入一个无法保证格式正确的数字（根据Wiki的语言环境）的话，你可以使用<code><nowiki>formatnum</nowiki></code>两次（但请不要在输入数字可能有数位分组格式的情况下使用这种变通方式，否则分隔符可能会消失或数字无法被格式化）。请注意这种方法是非常取巧的，因此它的输出结果可能不可靠。

{{Table-AnchorRow|dateformat|formatdate|#dateformat|#formatdate|.23dateformat|.23formatdate}}

|

<code><nowiki>{{#dateformat:</nowiki>'''date'''<nowiki>}}</nowiki></code><br>

<code><nowiki>{{#formatdate:</nowiki>'''date'''<nowiki>}}</nowiki></code><br>

<code><nowiki>{{#dateformat:</nowiki>'''date'''{{!}}'''format'''<nowiki>}}</nowiki></code><br>

<code><nowiki>{{#formatdate:</nowiki>'''date'''{{!}}'''format'''<nowiki>}}</nowiki></code>

|

<code><nowiki>{{#dateformat:25 dec 2009|ymd}}</nowiki></code> <br>

→ {{#dateformat:25 dec 2009|ymd}} （您的首选）2009年12月25日（默认） <br>

<code><nowiki>{{#formatdate:dec 25,2009|dmy}}</nowiki></code> <br>

→ {{#formatdate:dec 25,2009|dmy}} （您的首选）25日12月2009年（默认） <br>

<code><nowiki>{{#dateformat:2009-12-25|mdy}}</nowiki></code> <br>

→ {{#dateformat:2009-12-25|mdy}} （您的首选）12月25日，2009年（默认） <br>

<code><nowiki>{{#formatdate:2009 dec 25|ISO 8601}}</nowiki></code> <br>

→ {{#formatdate:2009 dec 25|ISO 8601}} （您的首选）2009-12-25（默认） <br>

<code><nowiki>{{#dateformat:25 decEmber|mdy}}</nowiki></code> <br>

→ {{#dateformat:25 decEmber|mdy}} （您的首选）12月25日（默认） <br>

'''注意'''：在上述例子中，“您的首选”仅指当前Wiki（也就是 MediaWiki.org）上的日期首选项。

| 根据用户的“日期格式”设置格式化给定日期，并添加将其标记为格式化日期的元数据。对于未登录的游客和没有在设置中指定日期格式的用户，日期可以按以下默认格式给定：<code>mdy</code>、<code>dmy</code>、<code>ymd</code>、<code>ISO&nbsp;8601</code>（大小写敏感）。如果只给定了月份和日期的话，只有 <code>mdy</code> 和 <code>dmy</code> 是合法格式。如果未给定日期格式或日期格式不合法，则输入格式将用作为默认格式。如果提供的日期未被识别为有效日期（特别是，如果它包含任何元数据，例如来自另一个 <code>dateformat</code>或类似模板的嵌套使用），则将其保持不变，并且不会生成额外的元数据。 <br>

{{warning|1=即使ISO 8601格式要求参数1的日期是公历日期，若参数2指定ISO 8601，函数也能对那些超出通常公历范围的日期进行格式化（例如1583年之前的日期）。不过，函数无法正确转换ISO 8601格式下的负数年份和通常格式下的公元前的年份。}}

{{Table-AnchorRow|lc|Lc|LC}}

|

<code><nowiki>{{lc:</nowiki>'''string'''<nowiki>}}</nowiki></code>

| <code><nowiki>{{lc:DATA CENTER}}</nowiki></code> → {{lc:DATA CENTER}}

| 小写输入。

{{Table-AnchorRow|lcfirst|Lcfirst|LCFIRST}}

|

<code><nowiki>{{lcfirst:</nowiki>'''string'''<nowiki>}}</nowiki></code>

| <code><nowiki>{{lcfirst:DATA center}}</nowiki></code> → {{lcfirst:DATA center}}

| 输入的内容会强制将<u>首字母</u>小写化。

{{Table-AnchorRow|uc|Uc|UC}}

|

<code><nowiki>{{uc:</nowiki>'''string'''<nowiki>}}</nowiki></code>

| <code><nowiki>{{uc:text transform}}</nowiki></code> → {{uc:text transform}}

| 大写输入。

{{Table-AnchorRow|ucfirst|Ucfirst|UCFIRST}}

|

<code><nowiki>{{ucfirst:</nowiki>'''string'''<nowiki>}}</nowiki></code>

| <code><nowiki>{{ucfirst:text tRAnSFORM}}</nowiki></code> → {{ucfirst:text tRAnSFORM}}

| 输入的内容会强制将<u>首字母</u>大写化。

{{Table-AnchorRow|padleft}}

<code><nowiki>{{padleft:xyz|</nowiki>'''stringlength'''<nowiki>}}</nowiki></code> <br>

<code><nowiki>{{padleft:xyz|</nowiki>'''strlen'''<nowiki>|</nowiki>'''char'''<nowiki>}}</nowiki></code> <br>

<code><nowiki>{{padleft:xyz|</nowiki>'''strlen'''<nowiki>|</nowiki>'''string'''<nowiki>}}</nowiki></code>

| <code><nowiki>{{padleft:xyz|5}}</nowiki></code> → {{padleft:xyz|5}} <br>

<code><nowiki>{{padleft:xyz|5|_}}</nowiki></code> → {{padleft:xyz|5|_}} <br>

<code><nowiki>{{padleft:xyz|5|abc}}</nowiki></code> → {{padleft:xyz|5|abc}}<br>

<code><nowiki>{{padleft:xyz|2}}</nowiki></code> → {{padleft:xyz|2}} <br>

<code><nowiki>{{padleft:|1|xyz}}</nowiki></code> → {{padleft:|1|xyz}}

（字符串的首字母） <br>

| 将参数1通过在左侧补上参数3指定的字符串（默认为0）补足到参数2指定的长度。 例如 <code><nowiki>{{padleft:44|3|0}}</nowiki></code> 生成 {{padleft:44|3}}。 参数3指定的字符串可能被截断以保证补足后的字符串长度满足要求。

在 1.12 版本以前，第三个参数只使用传入的字符串的第一个字符，但从 1.15 版本以后，第三个参数传入的字符串的所有字符都会被使用。

{{Table-AnchorRow|padright}}

|

<code><nowiki>{{padright:xyz|</nowiki>'''stringlength'''<nowiki>}}</nowiki></code> <br><code><nowiki>{{padright:xyz|</nowiki>'''strlen'''<nowiki>|</nowiki>'''char'''<nowiki>}}</nowiki></code> <br><code><nowiki>{{padright:xyz|</nowiki>'''strlen'''<nowiki>|</nowiki>'''string'''<nowiki>}}</nowiki></code>