Help:頁面狀態指示器

This page is a translated version of the page Help:Page status indicators and the translation is 100% complete.

頁面狀態指示器是显示在主要内容之外的图标（或短文本片段），可提供有关文章状态的快速信息（例如该页面是否被保护或是典范条目）。

它们也被称为顶部图标、页面图标或标题图标。

此功能在Gerrit change 162609的MediaWiki 1.25 版本中添加，以解决T25796并替换针对此问题的众多临时解决方案，例如英语维基百科的“top icon”模板。

自MediaWiki 1.43 起，MediaWiki会自动在页面状态指示器的区域显示页面保护状态。参见Help:Protection indicators 。

查看頁面狀態指示器

頁面狀態指示器通常显示在页面的右上角、主要内容之外或页面标题之前。它们的确切位置取决于皮肤。

新增頁面狀態指示器

使用以下语法在頁面狀態指示器，修改name属性和标签内容以适合您的喜好。

强烈建议为您需要的每种指示器类型创建一个模板，而不是直接在頁面中包含标签语法。

wikitext语法：

<indicator name="foo">[[File:Foo.svg|20px]]</indicator>

标签中使用模板参数时用的wikitext语法：

{{#tag:indicator
 |[[File:{{{1|Foo.svg}}}|20px]]
 |name="foo"
}}

Lua模块语法：

mw.getCurrentFrame():extensionTag {
	name = "indicator",
	content = '[[File:Foo.svg|20px]]',
	args = {
		name = "foo"
	}
}

请注意：

图片中的caption中的内容会出现在title属性中。
不局限于图片，您可以在这里添加任意的wikitext。（MediaWiki 1.39 开始才支持模板样式，参见T188443。）
每个指示器都必须有一个唯一的标识符（名称）。不能存在多个具有相同名称的指示器——如果出现重复，最后出现的标签将会胜出。
指示器按其名称（区分大小写）而非出现顺序显示。这确保了跨页面的一致性，并提供了一种对它们进行排序或分组的简单方法。
指示器不会被追踪。它们仅旨在反映页面上已经存在的内容或元資料，而不是資料本身。您应该能够使用适当的追踪分类、模板嵌入列表、特殊页面报告，或其他方式来列出包含给定指示器的页面。

已知問題

它们不会被Skin:Minerva Neue 展示，参见phab:T75299。
它们不能在VisualEditor 中预览
你不能在在指示器标签之间添加Extension:Widgets 的微件。

在您的wiki上自定义显示

如果您使用的皮肤支援頁面狀態指示器（所有預設外觀都支援），您可以使用站点和用户CSS调整它们的显示。要设置样式的CSS类是.mw-indicators（对于整个包含块）和.mw-indicator（对于每个单独的指示器）。

每个指示器还被赋予一个为#mw-indicator-name的ID，其中name是使用<indicator name="foo">语法分配给指示器的名称。

在外觀中支援指示器

在手册:SkinMustache.php 查看有关array-indicators的更多資訊。

在PHP程式碼使用指示器

存取OutputPage 物件并调用它的setIndicators()方法，传递一个ID和您想要显示的HTML字符串。如果要加入指向說明文件的帮助链接，请调用它的addHelpLink()方法，该方法也由SpecialPage 和其他类实现。这会在指示器区域中放置一个帮助链接；例如Special:WhatLinksHere。