⋮ Obsah
Navigační stopa (Breadcrumbs)
https://www.dokuwiki.org/breadcrumbs
V DokuWiki se nikdy neztratíte, protože vždy zanecháváte navigační (drobečkovou) stopu, která vám ukáže cestu zpět.
Typy navigační stopy
DokuWiki může zobrazovat dva typy navigační stopy: sledovací a hierarchickou.
Sledovací navigační stopa
Toto je výchozí nastavení. Navigační stopa zobrazuje seznam stránek, které jste právě navštívili ve wiki. Nejlépe se hodí pro stránky s plochou hierarchií jmenných prostorů. Sledovací navigační stopa je (v en verzi) označena předponou Trace: • .
Počet zobrazených sledovacích stop lze nastavit pomocí volby config:breadcrumbs.
Hierarchická navigační stopa
Hierarchická navigační stopa je běžná na stránkách řízených CMS s hlubokou navigační strukturou. Pokud vaše wiki používá přísně hierarchické jmenné prostory, můžete využít tento typ záložek. Po aktivaci se zobrazuje (v en verzi) předponou You are here:.
Hierarchickou navigační stopu lze aktivovat pomocí volby config:youarehere.
Konfigurace
- config:breadcrumbs Nastavte na 0 pro deaktivaci.
Text předpony navigační stopy
- Textový blok
Trace:pro sledovací navigační stopu aYou are here:pro hierarchickou navigační stopu nelze upravit přes Správce konfigurace. Lze je však upravit nebo odstranit přepsáním jazykové konfigurace. Například:- Anglický (
en) textTrace:lze upravit v souboruconf/lang/en/lang.phppřidáním$lang['breadcrumbs'] = ""(pro zobrazení bez předpony) nebo$lang['breadcrumbs'] = "Recent:"(pro změnu předpony). - Anglický (
en) textYou are here:lze upravit v souboruconf/lang/en/lang.phppřidáním$lang['youarehere'] = ""(pro zobrazení bez předpony) nebo$lang['youarehere'] = "Current Destination:"(pro změnu předpony).
- Způsob a umístění vykreslení bloku navigační stopy závisí především na šabloně.
- Šablona MIKIO s vysoce přizpůsobitelnou konfigurací má nastavení
breadcrumbPrefixTextpro vlastní úpravu: Pozor, jedná se pouze o jednu předponu použitou pro všechny typy navigační stopy, nikoli samostatně pro hierarchickou navigační stopu a sledovací navigační stopu. - Pokud si přejete upravit předponu ve svém pluginu:
- požádejte autora o možnost úpravy,
- nebo (jako rychlé řešení) najděte řetězec v šabloně a přepište ho,
- případně se podívejte, co nabízí localization v tomto ohledu.
Vývoj
Navigační stopy se ukládají do uživatelské relace. Vývojáři šablon by měli zajistit prostor pro oba typy navigační stopy pomocí funkcí tpl_breadcrumbs() a tpl_youarehere().