====== Navigační stopa (Breadcrumbs) ======

https://www.dokuwiki.org/breadcrumbs

V [[dokuwiki|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í [[namespaces|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 [[doku>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é [[namespaces|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 [[doku>config:youarehere]].

===== Konfigurace =====

  * [[doku>config:breadcrumbs]] Nastavte na 0 pro deaktivaci.
  * [[doku>config:youarehere]]

==== Text předpony navigační stopy ====

  * Textový blok ''Trace:'' pro [[#Sledovací navigační stopa|sledovací navigační stopu]] a ''You are here:'' pro [[#Hierarchická navigační stopa|hierarchickou navigační stopu]] nelze upravit přes [[doku>plugin:config|Správce konfigurace]]. Lze je však upravit nebo odstranit přepsáním jazykové konfigurace. Například:
    * Anglický (''en'') text ''Trace:'' lze upravit v souboru ''conf/lang/en/lang.php'' přidáním ''$lang['breadcrumbs'] = ""'' (pro zobrazení bez předpony) nebo ''$lang['breadcrumbs'] = "Recent:"'' (pro změnu předpony).
    * Anglický (''en'') text ''You are here:'' lze upravit v souboru ''conf/lang/en/lang.php'' př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ě.
  * [[template|Šablona]] [[doku>template:mikio|MIKIO]] s vysoce přizpůsobitelnou [[doku>template:mikio#configuration|konfigurací]] má nastavení ''breadcrumbPrefixText'' pro vlastní úpravu: Pozor, jedná se pouze o jednu předponu použitou pro všechny [[#typy navigační stopy]], nikoli samostatně pro [[#hierarchická navigační stopa|hierarchickou navigační stopu]] a [[#sledovací navigační stopa|sledovací navigační stopu]].
  * Pokud si přejete upravit předponu ve svém [[plugins|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í [[doku>localization]] v tomto ohledu.

===== Vývoj =====

Navigační stopy se ukládají do uživatelské relace. Vývojáři [[template|šablon]] by měli zajistit prostor pro oba typy navigační stopy pomocí funkcí ''tpl_breadcrumbs()'' a ''tpl_youarehere()''.