Rozšíření:BreadCrumbs2
![]() Stav rozšíření: stabilní |
|
---|---|
Implementace | Uživatelské rozhraní, Vzhled |
Popis | Poskytuje drobečkovou (breadcrumb) navigaci založenou na kategoriích |
Autoři | Eric Hartwell, Ike Hecht |
Správci | YOUR1 |
Nejnovější verze | 2.1.4 (2024-11-13) |
MediaWiki | >= 1.35.0 |
PHP | 5.5+ |
Licence | Creative Commons Uveďte autora 3.0 |
Stáhnout | |
Příklad | MediaWiki.org > Extensions > User interface > BreadCrumbs2 |
|
|
Čtvrtletní stahování | 13 (Ranked 54th) |
Přeložte rozšíření BreadCrumbs2, používá-li lokalizaci z translatewiki.net | |
Rozšíření BreadCrumbs2 generuje "breadcrumbs", které uživatelům pomáhají s navigací ve vaší wiki (za předpokladu, že má strukturu vhodnou pro navigaci). Drobečková (breadcrumbs) navigace vloží jeden řádek navigace před obsah stránky. Ukázková navigace pro tuto stránku je zobrazena výše ve světle žluté barvě.
Pro každou stránku může rozšíření použít kategorie a nebo jmenný prostor k:
- Vložení jednořádkového navigačního řetězce před obsah stránky
- Zvýraznění aktivního odkazu a nebo kartu postranního panelu
- Změně loga webu
- BreadCrumbs navigace používá jeden řádek textu k zobrazení umístění stránky v hierarchii webu... BreadCrumbs navigace byla vždycky jen sekundární navigační pomůckou... BreadCrumbs navigace usnadňuje uživatelům pohyb po webu, za předpokladu, že jeho obsah a celková struktura dávají smysl.[2]
BreadCrumbs2 je obzvláště užitečný se vzhledy jako GuMax, které zobrazují navigační lištu jako řádek záložek v horní části stránky místo nástrojů Diskuse/Úpravy/Historie.
Použití
Data BreadCrumb jsou uložena na stránce v jmenném prostoru MediaWiki, MediaWiki:Breadcrumbs
.
Pro přístup na stránku buď zadejte do vyhledávacího pole na vaší wiki MediaWiki:Breadcrumbs
a klikněte na ikonu hledání, nebo zkopírujte a vložte odkaz [[MediaWiki:Breadcrumbs]]
na stránku, poté ji otevřete a upravte.
Obsah je formátován jako wikitextový seznam s jedním řádkem na každou možnost navigace:
* category name @ breadcrumb wikitext @ tab name @ site logo
Přebytečné mezery mezi parametry jsou ignorovány.
Parametr | Typ | Popis |
---|---|---|
category name | Požadované | Pro každý řádek v seznamu zkontrolujte, zda je aktuální stránka členem kategorie, která odpovídá výrazu kategorie nebo jmennému prostoru se stejným názvem. |
breadcrumb wikitext | Volitelné | Text, který se má zobrazit v podtitulku s připojeným názvem stránky |
tab name | Volitelné | Panel záložek (navigace) s názvem název záložky, který odpovídá "kategorii", je označen jako aktivní. |
site logo | Volitelné | Použijte pro tuto stránku jiné logo webu. (Poznámka: Tuto možnost používejte opatrně.) |
Navigace
Rozšíření vloží před obsah stránky jednořádkový navigační řetězec.[3]
>
k vymezení úrovní navigace.[2]Například,
* Hook extensions @ [[Main Page|MediaWiki.org]] > [[:Category:Extensions|Extensions]] >
Vygeneruje pro tuto stránku následující navigační cestu:
MediaWiki.org > Extensions > BreadCrumbs2 |
Všimněte si, že BreadCrumbs2 používá první shodu s jmenným prostorem aktuální stránky nebo s jednou z kategorií stránky. Například pokud stránka s navigačními údaji obsahuje:
* Navigation extensions @ [[Main Page|MediaWiki.org]] > [[:Category:Extensions|Extensions]] > [[:Category:Navigation extensions|Navigation]] >
* User interface extensions @ [[Main Page|MediaWiki.org]] > [[:Category:Extensions|Extensions]] > [[:Category:User interface extensions|User interface]] >
Navigační linie pro tuto stránku by byla MediaWiki.org > Extensions > Navigace > Navigační linie2 a nikoli MediaWiki.org > Extensions > Uživatelské rozhraní > Navigační linie2, protože řádek Navigace je první.
Postranní panel
Aktivní odkaz v navigačním postranním panelu lze zvýraznit pomocí parametru tab name
, pokud je zadán.
To je obzvláště užitečné u vzhledů jako je GuMax, které zobrazují navigační panel jako řádek záložek v horní části stránky místo nástrojů Diskuse/Úpravy/Historie.
Site logo
If the site logo parameter is specified, an alternate image file is used instead of the site default. The path to this image is relative to the root of your wiki.
- Note
- Use this feature with caution so that it doesn't interfere with your site's usability. Subtle changes are good, but dramatic changes can be confusing. If your site needs significantly different look and feel between sections, consider using namespaces and namespace-specific styles and/or DynamicSkin.
Ke stažení
You can download the extension code, in .tar.gz format, via Special:ExtensionDistributor.
You can also download the code directly via Git from the MediaWiki source code repository. From a command line, you can call the following:
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/BreadCrumbs2.git
To view the code online, including version history for each file, go here.
Instalace
- Stáhněte soubor/y a vložte je do adresáře pojmenovaného
BreadCrumbs2
ve 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í:cd extensions/ git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/BreadCrumbs2
- Na konec vašeho souboru LocalSettings.php přidejte následující kód:
wfLoadExtension( 'BreadCrumbs2' );
- Vyžaduje nastavení v konfiguračním souboru.
- Create a new page called "MediaWiki:Breadcrumbs"
- Dokončeno – Přejděte na stránku Special:Version vaší wiki a zkontrolujte, zda bylo rozšíření úspěšně nainstalováno.
Konfigurace
$wgBreadCrumbs2RemoveBasePageLink
If breadcrumbs are defined for this page, remove the link back to the base page. Defaults to false
.
$wgBreadCrumbs2HideUnmatched
If no breadcrumbs are defined for this page, show nothing. Defaults to false
.
Tips, tricks, and hoops
- The breadcrumb list in
MediaWiki:Breadcrumbs
defines all the categories and subcategories used for navigation. - The extension uses the '@' character to delimit parameters instead of '|' as used in MediaWiki:Sidebar. This greatly simplifies the use of conditional templates in the breadcrumb list.
- If some of your users don't like the breadcrumbs, they can hide it with some CSS (see Manual:$wgAllowUserCss):
#breadcrumbs2 {
display: none;
}
Technical details
The breadcrumbs are built from the data page as follows:
- The string '@@@' is stripped from the text to be replaced with '@' before output (since the '@' character is used as a delimiter)
- Pseudo-variables of the form @@VAR@@ are evaluated.
- @@USERID@@: User ID, blank if anonymous
- @@USERGROUPS@@: Comma-delimited list of groups this user belongs to
- Templates and variables in the text are expanded. You can use parser functions like #if: if installed.
- The extension scans each line to find the first match with the current page's namespace or one of the page's categories.
- The remainder of the line is evaluated to set the breadcrumb string, sidebar, and/or logo (see below)
See also
- Extension:JSBreadCrumbs adds a trail of breadcrumbs below the tab bar.
- Extension:GeoCrumbs implements Wikivoyage's breadcrumbs. Breadcrumb navigation shows bread crumb menus under the title of an article to show the countries and regions that a destination belongs to.
References
- ↑ Street signs and Breadcrumbs, Chapter 6, Don't Make Me Think - Steve Krug (summary on Medium.com)
- ↑ 2.0 2.1 Navigace BreadCrumb stále užitečnější - Alertbox Jakoba Nielsena, 10. dubna 2007
- ↑ Pro navigační text lze použít libovolný wikitext, měl by se však omezit na jednoduchou sérii odkazů a oddělovačů.
Toto rozšíření je zahrnuto v následujících wiki farmách/hostitelích a/nebo balíčcích: Toto není autoritativní seznam. Některé wiki farmy/hostitelé a/nebo balíčky mohou toto rozšíření obsahovat, i když zde nejsou uvedeny. Pro potvrzení se vždy obraťte na své wiki farmy/hostitele nebo balíček. |