显示标题
Appearance
显示标题是与wiki页面关联的首选标题。 它通常提供页面标题中显示的文本字符串。 它在概念和技术上与页面标题 不同,页面标题 是记录页面并通过网络访问的标题。 默认情况下,显示标题是页面标题的同义词,但可以自定义以满足您的需求。
不同的wiki对页面标题和显示标题使用不同的命名约定。 例如,像维基百科这样的网站的惯例是,文章的页面标题应该是对主题的描述,而显示标题可以只定制为采用页面标题不支持的某些格式(小写首字母、斜体、上标)。 其他wiki可能更喜欢使用简短的、哈希生成的页面标题,而将描述性部分留给显示标题。 任何一种方法都是可行的。
MediaWiki 核心
对于用户和站点管理员
- 显示标题通常显示为页面的标题标题。 然而,一种更可靠的检查方法是查看通常称为页面信息 的汇总表。
- 除非选项
$wgAllowDisplayTitle
设置为false
,否则魔术字DISPLAYTITLE 允许您为页面设置自定义显示标题。 在某种程度上,它允许HTML格式选项,例如斜体。
配置设置:
名称 | 类型 | 描述 | 默认值 |
---|---|---|---|
$wgAllowDisplayTitle | boolean | 是否允许使用DISPLAYTITLE设置自定义显示标题。 | true
|
$wgRestrictDisplayTitle | boolean | 自定义是否应仅限于格式化。 | true
|
对于开发者
- 显示标题存储在
page_props
表的行中,其中pp_propname
等同于'displaytitle'
。 Its value is stored inpp_propvalue
. - 它可以在PHP中检索。 参见示例。
- PageProps::getProperties() - PageProps可以通过使用MediaWikiServices 调用。
- ParserOutput 类提供
getDisplayTitle()
和getPageProperties()
的方法。
- 可以使用ParserOutput 或
setDisplayTitle()
将其设置为setPageProperty()
。 - 它可以通过API检索。 参见示例。
Extensions
- Extension:DisplayTitle - 建立在魔术字DISPLAYTITLE的使用基础上,确保指向页面的wiki链接使用显示标题作为默认链接文本。 它还提供了一个解析器函数来查询页面的显示标题,以及一个在Lua中使用的等效函数。
- Extension:PageProperties - 允许您借助表单编辑显示标题和其他页面属性
- Extension:Semantic MediaWiki - 以DISPLAYTITLE为基础,通过自动将显示标题分配给名为“显示标题”的特殊属性。 参见 https://www.semantic-mediawiki.org/wiki/Help:Display_title