MediaWiki

Rozšíření:BreadCrumbs2

This page is a translated version of the page Extension:BreadCrumbs2 and the translation is 100% complete.
Languages:
MediaWiki.org > Extensions > Uživatelské rozhraní > Extension:BreadCrumbs2
Příručka k rozšířením MediaWiki
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
Stáhněte si rozšíření
Git [?]:
Příklad MediaWiki.org > Extensions > User interface > BreadCrumbs2
Parametry
  • $wgBreadCrumbs2RemoveBasePageLink
  • $wgBreadCrumbs2HideUnmatched
Použité háčky (hooks)
Č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ě.

Toto rozšíření vytváří navigační trasu v kategori "Where am I?"i (kde jsem). [1] používá Extension:JSBreadCrumbs pro navigační trasu v tradičním smyslu "How did I get here?" (jak jsem se sem dostal).

Pro každou stránku může rozšíření použít kategorie a nebo jmenný prostor k:

  1. Vložení jednořádkového navigačního řetězce před obsah stránky
  2. Zvýraznění aktivního odkazu a nebo kartu postranního panelu
  3. 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.

V seznamu navigace se vyhněte přidávání zbytečných prázdných řádků mezi položky.
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ě.)

Rozšíření vloží před obsah stránky jednořádkový navigační řetězec.[3]

Jakob Nielsen důrazně doporučuje webdesignérům používat znak > 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.

Název karty se porovnává se skutečným textem zobrazeným v postranním panelu, takže není nezávislý na jazyce.

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žce extensions/.
    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:

  1. The string '@@@' is stripped from the text to be replaced with '@' before output (since the '@' character is used as a delimiter)
  2. Pseudo-variables of the form @@VAR@@ are evaluated.
    • @@USERID@@: User ID, blank if anonymous
    • @@USERGROUPS@@: Comma-delimited list of groups this user belongs to
  3. Templates and variables in the text are expanded. You can use parser functions like #if: if installed.
  4. The extension scans each line to find the first match with the current page's namespace or one of the page's categories.
  5. The remainder of the line is evaluated to set the breadcrumb string, sidebar, and/or logo (see below)

See also

References

  1. ↑ Street signs and Breadcrumbs, Chapter 6, Don't Make Me Think - Steve Krug (summary on Medium.com)
  2. ↑ 2.0 2.1 Navigace BreadCrumb stále užitečnější - Alertbox Jakoba Nielsena, 10. dubna 2007
  3. ↑ Pro navigační text lze použít libovolný wikitext, měl by se však omezit na jednoduchou sérii odkazů a oddělovačů.
Retrieved from "https://www.mediawiki.org/w/index.php?title=Extension:BreadCrumbs2/cs&oldid=7724325"