Rozšíření:Záhlaví záložek
Stav rozšíření: stabilní |
|
|---|---|
| Implementace | Funkce analyzátoru , Uživatelské rozhraní |
| Popis | Zobrazuje záhlaví nejvyšší úrovně jako karty založené na JavaScriptu |
| Autoři | |
| Nejnovější verze | 2.4 (května 2025) |
| Zásady kompatibility | Větev master zachovává zpětnou kompatibilitu. |
| MediaWiki | 1.40+ |
|
|
| Licence | GNU General Public License 2.0 nebo novější |
| Stáhnout | Version history |
| Přeložte rozšíření Header Tabs, používá-li lokalizaci z translatewiki.net | |
| Problémy | Otevřené úkoly · Nahlásit chybu |
Rozšíření Header Tabs transformuje záhlaví MediaWiki nejvyšší úrovně (tj. záhlaví ohraničená jedním znakem "=") na karty založené na JavaScriptu.
Použití
Chcete-li po instalaci rozšíření povolit karty na stránce, musíte na stránku přidat tag <headertabs /> na místo, kde by měla končit poslední karta (vše pod tímto tagem se zobrazí v zobrazení karet).
Většinou ho ale budete chtít umístit na konec stránky.
Kromě toho by stránka měla mít hlavičky nejvyšší úrovně definované takto:
= Nadpis záhlaví =
Každá taková hlavička nejvyšší úrovně, pokud se nachází kdekoli nad tagem <headertabs />, se zobrazí jako záložka.
Odkazování na karty
Na kartu můžete odkazovat jak z jiné stránky, tak i ze stejné stránky (a v rámci stejné stránky jak z jiné karty, tak i mimo zobrazení karet).
To se provádí pomocí parserové funkce {{#switchtablink}}, která se volá takto:
{{#switchtablink:Název karty|Text odkazu|Název stránky}}
Tím se vytvoří odkaz na kartu s názvem "Název karty" a text odkazu bude znít jako "Text odkazu". Pokud chcete, aby odkaz směřoval na kartu na jiné stránce, můžete volitelně přidat třetí parametr "Název stránky".
Příklad
Nějaký text nad zobrazením záložek
= Záhlaví první sekce =
Toto se zobrazí na první kartě
{{#switchtablink:Záhlaví druhé sekce|Kliknutím sem přejdete na další kartu...}}
= Záhlaví druhé sekce =
Toto se zobrazí na druhé kartě
<headertabs/>
= Záhlaví třetí sekce =
Toto se bude vždy zobrazovat v zobrazení záložek, protože je pod tagem <headertabs/>.
Názvy záhlaví se automaticky převedou na názvy karet.
Ke stažení
Kód pro záložky záhlaví si můžete stáhnout ve formátu .zip: https://github.com/wikimedia/mediawiki-extensions-HeaderTabs/archive/2.4.zip
Kód si také můžete stáhnout přímo přes Git z úložiště zdrojového kódu MediaWiki. Z příkazového řádku zavolejte následující:
gitclonehttps://phabricator.wikimedia.org/diffusion/EHET/extension-headertabs.git
Chcete-li zobrazit kód online, včetně historie verzí jednotlivých souborů: https://phabricator.wikimedia.org/diffusion/EHET/browse/master/
Instalace
- Stáhněte soubor/y a vložte je do adresáře pojmenovaného
HeaderTabsve vaší složceextensions/.
Vývojáři a přispěvatelé kódu by si místo toho měli nainstalovat rozšíření from Git pomocí:cdextensions/ gitclonehttps://gerrit.wikimedia.org/r/mediawiki/extensions/HeaderTabs - Na konec vašeho souboru LocalSettings.php přidejte následující kód:
wfLoadExtension( 'HeaderTabs' );
- Yes Dokončeno – Přejděte na stránku
Special:Versionvaší wiki a zkontrolujte, zda bylo rozšíření úspěšně nainstalováno.
Úpravy
Úprava vzhledu
Chcete-li změnit styl záložek, podívejte se na Modifikace vzhledu .
Parametry konfigurace
Následující parametry lze upravit v proměnné LocalSettings.php pod voláním funkce wfLoadExtension().
$wgHeaderTabsRenderSingleTab
Proměnná $wgHeaderTabsRenderSingleTab definuje, zda se karty záhlaví aktivují, pokud je nalezena pouze jedna záhlaví nejvyšší úrovně.
Ve výchozím nastavení je tato proměnná nastavena na hodnotu false, tj. pokud je nalezena pouze jedna hlavička nejvyšší úrovně, nezobrazí se žádné karty.
Toto chování můžete povolit přidáním následujícího:
$wgHeaderTabsRenderSingleTab = true;
$wgHeaderTabsAutomaticNamespaces
Proměnná $wgHeaderTabsAutomaticNamespaces definuje sadu jmenných prostorů, pro které není nutné přidávat tag <headertabs />, aby bylo možné povolit tabulaci.
Pokud je v této proměnné definováno ID jmenného prostoru, záložky záhlaví se aktivují automaticky, pokud máte v článku dvě záhlaví nejvyšší úrovně (nebo jedno, pokud máte proměnnou $wgHeaderTabsRenderSingleTab nastavenou na true).
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.
Ve výchozím nastavení je tato proměnná nastavena na hodnotu false.
Toto chování můžete povolit přidáním výchozího názvu pomocí následujícího příkazu:
$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;
Historie verzí
To see a list of changes for each version, see version history. For a list of features planned for future releases, please see roadmap.
Známá omezení a problémy
- 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.
Sekce zobrazené mimo sekci s kartami
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.
Podpora
The best way to seek help with this extension is to send questions to the mediawiki-l mailing list. Správci rozšíření a aktivní uživatelé a přispěvatelé jsou na tomto seznamu a budou vám schopni pomoci.
Přispívání do projektu
Chyby a požadavky na funkce
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.
Přispívání záplat do projektu
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
Pokud vytvoříte opravu, zašlete ji s popisem Yaronovi Korenovi.
Překládání
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.
Související odkazy
- Stable extensions/cs
- Parser function extensions/cs
- User interface extensions/cs
- EditPageGetDiffContent extensions/cs
- EditPageGetPreviewContent extensions/cs
- ParserAfterTidy extensions/cs
- ParserFirstCallInit extensions/cs
- ResourceLoaderGetConfigVars extensions/cs
- GPL licensed extensions/cs
- Extensions in Wikimedia version control/cs
- All extensions/cs
- Extensions included in BlueSpice/cs
- Extensions included in Canasta/cs
- Extensions included in Miraheze/cs
- Extensions included in MyWikis/cs
- Extensions included in ProWiki/cs