帮助:页面状态指示符

From mediawiki.org
Jump to navigation Jump to search
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"} }

请注意:

  • 每个指示符都必须有一个唯一的标识符(名称)。 不能存在多个具有相同名称的指示符——如果出现重复,最后出现的标签将会胜出。
  • 指示符按其名称(区分大小写)而非出现顺序显示。 这确保了跨页面的一致性,并提供了一种对它们进行排序或分组的简单方法。
  • 指示符不会被追踪。 它们仅旨在反映页面上已经存在的内容或元数据,而不是数据本身。 您应该能够使用适当的追踪分类 、模板嵌入包含 列表、特殊页面 报告,或其他方式来列出包含给定指示符的页面。
  • 模板樣式 目前不被支持(参见T188443)。

在您的wiki上自定义显示

如果您使用的皮肤支持页面状态指示符(所有默认皮肤都支持),您可以使用站点和用户CSS调整它们的显示。 要设置样式的CSS类是.mw-indicators(对于整个包含块)和.mw-indicator(对于每个单独的指示符)。

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

在皮肤中添加对指示符的支持

参见Manual:Skinning Part 2#Page status indicators

从PHP代码中使用指示符

访问OutputPage 对象并调用它的setIndicators()方法,传递一个ID和您想要显示的HTML字符串。 如果要向文档添加帮助链接,请调用它的addHelpLink()方法,该方法也由SpecialPage 和其他类实现。 这会在指示符区域中放置一个帮助链接;例如Special:WhatLinksHere