扩展名:标题选项卡

来自MediaWiki.org
跳转到导航 跳转到搜索
MediaWiki扩展手册
OOjs UI icon advanced.svg
标题选项卡
发布状态: 稳定的
实施 分析器函数 ,用户界面
说明 将顶级标题显示为基于JavaScript的选项卡
作者
最新版本 1.3(2020年1月)
维基百科 1.28条+
许可证 GNU通用公共许可证2.0或更高版本
下载
版本历史记录
例子 semantic-mediawiki.org上的本月Wiki
  • $wgheaderabsrendersingletab
  • $wgheaderAbsDisableDefaultToc
  • $wgheadertabs自动命名空间
  • $wgheaderAbseditTableLink
  • $wgheadertabsgeneratabtocs
  • $wgHeaderTabsDefaultFirstTab
  • $wgheaderabsuseHistory/历史记录
转换标题选项卡扩展如果在translatewiki.net上有
检查使用情况和版本矩阵。

这个标题选项卡扩展使用jQuery用户界面JavaScript库。

使用[编辑]

要在安装扩展后启用页上的选项卡,需要添加

<headertabs/>

标记到最后一个选项卡应结束的位置(此标记下的所有内容都将显示在选项卡视图下)。不过,大多数时候,你会想把它放在页面的底部。

除此之外,页面中还应该定义顶级标题,如下所示:

=标题标题=

每一个这样的顶级标题,如果它位于<headertabs/>标记上方的任何地方,都将显示为一个选项卡。

链接到选项卡[编辑]

您可以从另一个页面和同一个页面内链接到一个选项卡(在同一个页面中,可以从另一个选项卡和选项卡视图外部链接到一个选项卡)。这是通过使用{开关}解析器函数,调用如下:

{{switchtablink:选项卡名称|链接文本|页面名称}

这将创建一个名为“tab name”的标签链接,链接文本将显示为“link text”。如果希望链接指向另一个页面上的选项卡,可以选择添加第三个参数“page name”。

注意 注:多字节字符也是格式化字符,例如,如果要以任何方式链接到选项卡,则不允许使用粗体。

例子[编辑]

选项卡视图上方的某些文本
 
=第一节标题=
这将显示在第一个选项卡
{{#SwitchTableLink:section header:section header |单击此处转到下一个选项卡…}
=section header=
这将显示在第二个选项卡上
<headertabs/>
=Third section header=
;这将始终显示在选项卡视图
下,因为它在下面<headertabs/>标记。

标题标题将自动转换为选项卡标题。

下载[编辑]

你可以下载标题标签代码,格式为.zip,在这里.

您也可以通过Git直接从MediaWiki源代码库下载代码。从命令行调用以下命令:

git克隆https://phabricator.wikimedia.org/diffusion/EHET/extension-headertabs.git

要联机查看代码,包括每个文件的版本历史记录,请转到在这里.

安装[编辑]

  • 下载并将文件放入名为塔斯头在你的扩展/文件夹。

修改[编辑]

皮肤修饰[编辑]

要更改选项卡的样式,请参阅“皮肤修饰".

配置参数[编辑]

下面的LocalSettings.php中可以修改以下参数需要一次(…).

$wgheaderabsuseHistory/历史记录[编辑]

$wgheaderabsuseHistory/历史记录定义是否应在浏览器历史记录和URL内跟踪选项卡导航,并更新哈希值。默认情况下,此变量设置为true。您可以通过添加以下内容来禁用它:

$wgheaderabsuseHistory/历史记录 = ;

$wgheaderabsrendersingletab[编辑]

这个$wgheaderabsrendersingletab变量定义只有一个顶级标题时标题选项卡是否激活。默认情况下,此变量设置为false,即如果只找到一个顶级标题,则不会显示选项卡。您可以通过添加以下内容来启用此行为:

$wgheaderabsrendersingletab = 是的;

$wgheadertabs自动命名空间[编辑]

这个$wgheadertabs自动命名空间变量定义不需要为其添加<headertabs/>标记以启用选项卡。如果在这个变量中定义了一个命名空间ID,那么当您有两个顶级头(或者一个,如果您有)时,header选项卡将自动激活$wgheaderabsrendersingletab设置为true)在文章中。默认情况下,此变量不包含名称空间。通过为每个命名空间添加以下内容,可以将命名空间添加到此列表中:

$wgheadertabs自动命名空间[] = 新罕布什尔州;

$wgHeaderTabsDefaultFirstTab[编辑]

这个$wgHeaderTabsDefaultFirstTab变量定义头选项卡是否将任何内容放在第一个定义的头之前,并将其放入自己的选项卡中。默认情况下,此变量设置为false。可以通过使用以下命令添加默认名称来启用此行为:

$wgHeaderTabsDefaultFirstTab = 'DefaultTabName';

如果使用此设置,请小心不要启用$wgheaderabsrendersingletab因为它会导致选项卡出现在UI的其他部分。

$wgheaderAbsDisableDefaultToc[编辑]

这个$wgheaderAbsDisableDefaultToc变量定义当为给定文章启用选项卡时,标题选项卡是否将禁用MediaWiki文章的目录(TOC)。这样就省去了添加__诺托克__到你的文章。如果由于缺少顶级标题而未启用选项卡,则目录将照常显示。默认情况下,此变量设置为true,即如果显示标题选项卡,则禁用MediaWiki TOC。可以通过添加以下内容禁用此行为:

$wgheaderAbsDisableDefaultToc = ;

$wgheadertabsgeneratabtocs[编辑]

这个$wgheadertabsgeneratabtocs变量定义标题选项卡是否将尝试为每个选项卡生成TOC。默认情况下,此变量设置为false,即不会生成制表符目录。可以通过添加以下内容来启用此行为:

$wgheadertabsgeneratabtocs = 是的;

$wgheaderAbseditTableLink[编辑]

这个$wgheaderAbseditTableLink变量定义标题选项卡是否将在选项卡右侧添加编辑链接,该链接允许您仅编辑选项卡的文本。默认情况下,此变量设置为true,即显示选项卡的编辑链接。可以通过添加以下内容禁用此行为:

$wgheaderAbseditTableLink = ;

$wgHeaderTabsStyle[编辑]

这个$wgHeaderTabsStyle变量定义选项卡使用的视觉样式。默认情况下,此变量设置为“大”。可以通过添加以下内容来更改样式:

$wgHeaderTabsStyle = '样式名称';

扩展包括的样式包括:

姓名 说明 截图
jquery公司 MediaWiki提供的基本样式-它使文本变小,链接变黑。
大的 默认样式。它使文本大小正常,并再次将链接变为蓝色(或红色)。
光秃秃的 类似于“大”样式的格式,但是没有大多数边框和背景颜色,因此页面唯一真正的变化是选项卡本身。
永恒的 有光泽的链接,有更多的蓝色标签。

我们提供了更广泛的用户定制风格选择,以及关于如何创建自己的风格的信息/皮肤修饰第页。

版本历史记录[编辑]

要查看每个版本的更改列表,请参阅历史版本. 有关计划在未来版本中使用的功能的列表,请参见路线图.

已知限制和问题[编辑]

  • 不能多次使用标记。换句话说,第二个标签不会产生第二系列标签。
  • 标签在Chrome中的信息框顶部呈现。
  • 标题选项卡不能与HTML Tidy工具一起使用,即如果$wgTidyConfig 已填充。

不兼容的扩展和皮肤[编辑]

与以下扩展一起使用时,标题选项卡似乎不起作用:

  • 马查克斯-当两者一起使用时,它会导致错误的HTML,导致至少Firefox浏览器的显示中断。(随着MathJax的更新,情况可能会发生变化。)您可以通过添加\uu NOMATHJAX来禁用特定页面上的MathJax。
  • 加上这个小装置)-仅显示第一个选项卡
  • 笨手笨脚的-和AddThis一样。
  • 移动前端-和AddThis一样。
  • 分区隐藏-由于两个扩展更改了节的行为,因此不兼容。SectionHide现在包含一个自动检查,它将通知用户扩展名不适用于标题选项卡。
  • 回声-似乎导致标题选项卡的显示问题。
  • 特威基-Skin Tweeki破坏了布局并隐藏了标签的文本

出现在选项卡节外部的节[编辑]

如果其他内容不强制容器足够大以容纳浮动对象,则包含浮动对象(如infobox)的标题选项卡部分可能会出现在选项卡容器外部。解决这个问题的一个方法是在每个部分的末尾放置一个清除的html元素。一种简单但不是最佳实践的方法是:

<迪夫 风格=“清除:两个”></迪夫>

这将强制浏览器在浮动对象之后考虑此元素,从而使容器增大以适合两者。

支持[编辑]

寻求此扩展帮助的最佳方法是将问题发送给mediawiki-l邮件列表. 扩展维护人员、活动用户和贡献者都在这个列表中,它们将能够帮助您。

另请参见[编辑]