Extension:Header Tabs

**MediaWiki 拡張機能マニュアル**
Header Tabs リリースの状態: 安定

実装	パーサー関数 , ユーザーインターフェイス
説明	Displays top-level headers as JavaScript-based tabs
作者	Sergey Chernyshev Yaron Koren Priyanshu Varshney
最新バージョン	2.2.2 (2023年9月)
互換性の方針	master は後方互換性を維持しています。
MediaWiki	1.33+
ライセンス	GNU 一般公衆利用許諾書 2.0 以降
ダウンロード	拡張機能をダウンロード Git ^[?]: Git master をダウンロードリポジトリを参照 (GitHub) コミット履歴リポジトリの貢献者 (GitHub) コードレビュー Version history
例	Wiki of the Month on semantic-mediawiki.org meza.wiki/headertabs
パラメーター $wgHeaderTabsRenderSingleTab $wgHeaderTabsDisableDefaultToc $wgHeaderTabsAutomaticNamespaces $wgHeaderTabsNoTabsInToc $wgHeaderTabsEditTabLink $wgHeaderTabsGenerateTabTocs $wgHeaderTabsDefaultFirstTab $wgHeaderTabsUseHistory
使用するフック ParserAfterTidy ParserFirstCallInit ResourceLoaderGetConfigVars
translatewiki.net で翻訳を利用できる場合は、Header Tabs 拡張機能の翻訳にご協力ください
問題点	未解決のタスク · バグを報告

The Header Tabs extension transforms top-level MediaWiki headers (i.e., headers surrounded by a single "=") into JavaScript-based tabs.

使用法

To enable tabs on a page after you installed the extension, you need to add a ‎<headertabs /> tag into the page in place where the last tab should end (everything below this tag will be shown under the tab view). Most of the time, though, you'll want to put it at the bottom of the page.

In addition to that, the page should have top-level headers defined in it like this:

= 見出し =

Each such top-level header, if it's anywhere above the ‎<headertabs /> tag, will be displayed as a tab.

Linking to tabs

You can link to a tab, both from another page and from within that same page (and, within that same page, both from another tab and from outside the tab view). This is done using the {{#switchtablink}} parser function, which is called like this:

{{#switchtablink:タブ名|リンク テキスト|ページ名}}

This will create a link to the tab with the name "Tab name", and the text of the link will read "Link text". If you want the link to a point to a tab on another page, you can optionally add the third parameter, "Page name".

Multibyte characters as well as formatting characters (e.g. bold) are not permitted if you want to link to tabs in any way.

例

タブ表示の上のテキスト

= 最初の節見出し =
これは最初のタブに表示されます

{{#switchtablink:2番めの節見出し|次のタブに遷移するにはここをクリック...}}

= 2番めの節見出し =
これは2番めのタブに表示されます

<headertabs/>
= 3番目の節見出し =
これは <headertabs/> タグの下にあるため、常にタブ表示の下に表示されます。

見出しは自動的にタブ名に変換されます。

ダウンロード

Header Tabs のコードは .zip 形式でダウンロードできます: https://github.com/wikimedia/mediawiki-extensions-HeaderTabs/archive/2.2.2.zip

You can also download the code directly via Git from the MediaWiki source code repository. From a command line, call the following:

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

各ファイルのバージョン履歴を含むコードをオンラインで閲覧するにはこちら: https://phabricator.wikimedia.org/diffusion/EHET/browse/master/

インストール

ダウンロードして、ファイルをextensions/フォルダー内のHeaderTabsという名前のディレクトリ内に配置します。
開発者とコード寄稿者は、上記の代わりに以下を使用してGitからインストールします:cd extensions/ git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/HeaderTabs
以下のコードを LocalSettings.php ファイルの末尾に追加します:
```
wfLoadExtension( 'HeaderTabs' );
```
完了 – ウィキの「Special:Version」に移動して、拡張機能が正しくインストールされたことを確認します。

Modifications

Skin modification

To change the tabs' styling, see "Skin modification".

設定のパラメーター

The following parameters can be modified in LocalSettings.php below the call to wfLoadExtension().

$wgHeaderTabsUseHistory

$wgHeaderTabsUseHistory defines whether tab navigation should be tracked within the browser history and within the URL, updating the hash value. By default this variable is set to true, i.e. history is used. You can disable it by adding the following:

$wgHeaderTabsUseHistory = false;

$wgHeaderTabsRenderSingleTab

The $wgHeaderTabsRenderSingleTab variable defines if Header Tabs will activate if only a single top-level header is found. By default this variable is set to false, i.e. no tabs will be shown if only one top-level header is found. You can enable this behaviour by adding the following:

$wgHeaderTabsRenderSingleTab = true;

$wgHeaderTabsAutomaticNamespaces

The $wgHeaderTabsAutomaticNamespaces variable defines the set of namespaces for which you don't need to add the <headertabs /> tag in order to enable tabs. If a namespace ID is defined in this variable, header tabs will activate automatically when you have two top-level headers (or one, if you have $wgHeaderTabsRenderSingleTab set to true) in an article. By default this variable holds no namespaces. You can add namespaces to this list by adding the following for each namespace:

$wgHeaderTabsAutomaticNamespaces[] = NS_MAIN;

$wgHeaderTabsDefaultFirstTab

The $wgHeaderTabsDefaultFirstTab variable defines whether Header Tabs puts any content before the first defined header and put it into its own tab. By default this variable is set to false. You can enable this behavior by adding the default name using the following:

$wgHeaderTabsDefaultFirstTab = 'DefaultTabName';

If using this setting, be careful not to enable $wgHeaderTabsRenderSingleTab as it will lead to tabs appearing in other parts of the UI.

$wgHeaderTabsDisableDefaultToc

The $wgHeaderTabsDisableDefaultToc variable defines whether Header Tabs will disable the MediaWiki article's table of contents (TOC) when tabs are enabled for a given article. This saves you the trouble of having to add __NOTOC__ to your article. If tabs are not enabled because of a lack of top-level headers, the table of contents will appear as usual. By default this variable is set to true, i.e. the MediaWiki TOC is disabled if header tabs are shown. You can disable this behavior by adding the following:

$wgHeaderTabsDisableDefaultToc = false;

$wgHeaderTabsNoTabsInToc

If you want the page to have a TOC, but do not want to include the tab names in that TOC, add the following to LocalSettings.php:

$wgHeaderTabsNoTabsInToc = true;

If, however, you only want to keep the tabs out of the TOC in some but not all pages, you can instead add the following to the top of any such pages:

<notabtoc/>

$wgHeaderTabsGenerateTabTocs

The $wgHeaderTabsGenerateTabTocs variable defines if Header Tabs will try to generate a TOC for each tab. By default this variable is set to false, i.e. no tab TOCs will be generated. You can enable this behavior by adding the following:

$wgHeaderTabsGenerateTabTocs = true;

$wgHeaderTabsEditTabLink

The $wgHeaderTabsEditTabLink variable defines if Header Tabs will add a edit link to the right of the tabs which let you edit only the tabs' text. By default this variable is set to true, i.e. a edit link for the tab will be shown. You can disable this behavior by adding the following:

$wgHeaderTabsEditTabLink = false;

バージョン履歴

To see a list of changes for each version, see version history. For a list of features planned for future releases, please see roadmap.

既知の制限と問題点

You cannot use the tag more than once. In other words, a second tag will not produce a second series of tabs.
Tabs render on top of infoboxes in Chrome.
Header Tabs will not work with the HTML Tidy tool, i.e. if $wgTidyConfig is populated.

Sections appearing outside the tabbed section

Header Tabs sections which include floated objects (such as infoboxes) may appear outside the tabs container if other content does not force the container to be large enough to hold the floated object. One resolution to this problem is to place a cleared html element at the very end of each section.

A simple, but not best-practice, means of doing this is:

<div style="clear:both"></div>

This forces this element to be considered by the browser after your floated object and thus will grow the container to fit both.

サポート

The best way to seek help with this extension is to send questions to the mediawiki-l mailing list. The extension maintainers, and active users and contributors, are on this list and will be able to help you.

Contributing to the project

Bugs and feature requests

There are a number of ways to get support for Header Tabs, including questions, suggestions, bug reports and feature requests:

Place questions on the discussion page for Header Tabs.
You can submit bug reports and feature requests at MediaWiki's Phabricator site, here; enter "Header Tabs" in the "Tags" field. (The current list of known bugs and requested features for Header Tabs can be found here.)
Use the main MediaWiki mailing list, mediawiki-l.

Contributing patches to the project

If you found some bug and fixed it, or if you wrote code for a new feature, please either do a Git commit for it, or create a patch by going to the "HeaderTabs" directory, and typing:

git diff > descriptivename.patch

If you create a patch, please send it, with a description, to Yaron Koren.

翻訳

Translation of Header Tabs is done through translatewiki.net. The translation for this extension can be found here: https://translatewiki.net/wiki/Special:Translate?group=ext-headertabs. To add language values or change existing ones, you should create an account on translatewiki.net, then request permission from the administrators to translate a certain language or languages on this page (this is a very simple process). Once you have permission for a given language, you can log in and add or edit whatever messages you want to in that language.

使用法