Jmenné prostory

DokuWiki umožňuje roztřídit jednotlivé typy dokumentů (stránek) do skupin, které se nazývají Jmenné prostory. Představte si je jako adresáře. Například všechny strany o DokuWiki jsou v jmenném prostoru (adresáři) wiki. Jmenné prostory se vytváří pomocí dvojtečky (:) v odkazu. Alternativně lze použít středník nebo lomítko (pokud je to nastaveno v konfiguraci). Poznámka: V této konfiguraci to nastaveno není.

Pokud v odkazu dvojtečna není, směřuje odkaz do aktuálně nastaveného prostoru. Zadáním dvojtečky na začátek se nastavuje defaultní prostor - hlavní adresář. Zde je několik příkladů:

  * [[wiki:start]] odkazuje na ''wiki:start''
  * [[start]] odkazuje na ''wiki:start'' (pokud se link nachází v prosotru ''wiki'')
  * [[:start]] odkazuje na ''start''

Někdy chceme mít odkaz na jmenný prostor v jiném prostoru (podadresář) bez toho abychom museli zadávat celou cestu. Pokud na začátek odkazu napíšete tečku (.), tak ta znamená, že počátek cesty je v aktuálním jmenném prostoru. Například:

  * [[diskuze]] odkazuje na ''wiki:diskuze''
  * [[diskuze:o životě]] odkazuje na ''diskuze:o životě''
  * [[.diskuze:o životě]] odkazuje na ''wiki:diskuze:o životě''

Jmenné prostory jsou velmi užitečné při určování kategorie nebo struktury obsahu.

Jmenné prostory umožňují udržovat obsah stejného typu odděleně od ostatních typů. Toto rozdělení má dvě úrovně: uložení a odkazování.

Například: Máte čtyři strany: První a druhá je v prostoru wiki - Help a Manuál, třetí je v prostoru foto - Galerie a čtvrtá - Home je přímo v rootu, tedy v hlavním adresáři.

  1. Odkaz (wiki) Help → (wiki) Manuál se zapíše [[Manuál]]. Odkaz ve stejném jmenném prostoru bude bez uvedení prostoru.
  2. Odkaz (wiki) Help → (foto) Galerie se zapíše [[foto:Galerie]]. Odkaz napříč jmennými prostory. Musí být uveden se jménem prostoru.
  3. Odkaz (foto) Galerie → (wiki) Help se zapíše [[wiki:Help]]. Odkaz napříč jmennými prostory. Musí být uveden se jménem prostoru.
  4. Odkaz (wiki) Help → () Home se zapíše [[:Home]]. Odkaz napříč jmennými prostory. Když je dokument v rootu, tak se zapíše jen dvojtečka.

Poznámka: Výrazy strana a dokument v tomto textu znamenají jedno a to samé: dokument = HTML strana.