Extension:Header Tabs

Manuel des extensions MediaWiki

Header Tabs État de la version : stable
Implémentation	Fonction d'analyseur , Interface utilisateur
Description	Affiche les titres de plus haut niveau en onglets grâce au JavaScript
Auteur(s)	Sergey Chernyshev Yaron Koren Priyanshu Varshney
Dernière version	2.3 (octobre 2024)
Politique de compatibilité	Le master conserve la compatibilité arrière.
MediaWiki	1.33
Licence	Licence publique générale GNU v2.0 ou supérieur
Téléchargement	Télécharger l'extension Git [?]: Télécharger la branche master de Git parcourir le dépôt (GitHub) historique des validations (commits) contributeurs du dépôt (GitHub) relecture du code Version history
Paramètres $wgHeaderTabsRenderSingleTab $wgHeaderTabsEditTabLink $wgHeaderTabsAutomaticNamespaces $wgHeaderTabsDefaultFirstTab $wgHeaderTabsNoTabsInToc
Accroches utilisées EditPageGetDiffContent EditPageGetPreviewContent ParserAfterTidy ParserFirstCallInit ResourceLoaderGetConfigVars
Traduire l’extension Header Tabs sur translatewiki.net si elle y est disponible
Problèmes	Tâches ouvertes · Signaler un bogue

L'extention Header Tabs transforme les titres de plus haut niveau, entourés par un unique "=" en onglets JavaScript.

Utilisation

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). En général, la balise sera posée au bas de la page.

La page doit aussi avoir des titres définis au plus haut niveau tels que :

= Mon titre =

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

Liens vers les onglets

Vous pouvez créer un lien vers l'onglet, depuis une autre page ou de l'intérieur de la page, et dans celle-ci, depuis un autre onglet ou hors des onglets. This is done using the {{#switchtablink}} parser function, which is called like this:

{{#switchtablink:Nom de l'onglet|Texte du lien|Nom de la page}}

Cela créera un lien vers l'onglet nommé "Nom de l'onglet" avec comme texte de lien : "Texte du lien". Si vous voulez un lien pointant vers un onglet d'une autre page, vous devez ajouter le troisième paramètre optionnel : "Nom de la page".

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

Exemple

Some text above the tab view

= First section header =
This will be displayed on the first tab

{{#switchtablink:Second section header|Click here to go to the next tab...}}

= Second section header =
This will be displayed on the second tab

<headertabs/>
= Third section header =
This will be always displayed under the tab view because it's below the <headertabs/> tag.

The header titles get automatically converted into tab titles.

Téléchargement

Vous pouvez télécharger le code de Header Tabs, dans le format .zip ici https://github.com/wikimedia/mediawiki-extensions-HeaderTabs/archive/2.3.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

To view the code online, including the version history for each file: https://phabricator.wikimedia.org/diffusion/EHET/browse/master/

Installation

• Téléchargez et placez le(s) fichier(s) dans un répertoire appelé HeaderTabs dans votre dossier extensions/.
  Les développeurs et les contributeurs au code doivent à la place installer l'extension à partir de Git en utilisant:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/HeaderTabs
• Ajoutez le code suivant à la fin de votre fichier LocalSettings.php  :

  wfLoadExtension( 'HeaderTabs' );
  

•  Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.

Modifications

Skin modification

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

Paramètres de configuration

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

$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.

$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/>

$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;

Historique des versions

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

Known limitations and issues

• 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.

Support

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.

Translating

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.

Voir aussi

• Extension:TabberNeue
• Extension:Tabs