Help:頁面狀態指示器

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

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

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

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

查看頁面狀態指示器

Vector皮肤截图,頁面狀態指示器区域被标注出来。

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

新增頁面狀態指示器

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

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

wikitext语法:

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

Lua模块语法:

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

请注意:

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

已知問題

在您的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