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ů:

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

  * [[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
o životě odkazuje na diskuze:o životě
o životě odkazuje na wiki:diskuze:o životě

  * [[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í.

uložení - jmenné prostory jsou na serveru uloženy v adresářích (složkách). To umožňuje mít obsah stejného typu v jednom adresáři. Velmi užitečné pro administátory, kteří pracují se zdrojovým textem. Například: zálohování všech dokumentů projektu XYZ ⇒ backup folder projectXYZ/*.txt
odkazování - Jmenné prostory se do odkazů nemusí vkládat na všech stranách, které se v něm nacházejí. Když je strana v prostoru <name> a chcete z ní vést odkaz na jinou stranu v prostoru <name>, tak se do odkazu prostor nedává. Ten tam musí být jen v případě, že se do prostoru <name> odkazuje zvenčí - z jiného prostoru.

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.

Odkaz (wiki) Help → (wiki) Manuál se zapíše [[Manuál]]. Odkaz ve stejném jmenném prostoru bude bez uvedení prostoru.
Odkaz (wiki) Help → (foto) Galerie se zapíše [[foto:Galerie]]. Odkaz napříč jmennými prostory. Musí být uveden se jménem prostoru.
Odkaz (foto) Galerie → (wiki) Help se zapíše [[wiki:Help]]. Odkaz napříč jmennými prostory. Musí být uveden se jménem prostoru.
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.