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:
wiki:diskuze
diskuze:o životě
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í.
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.
[[Manuál]]
. Odkaz ve stejném jmenném prostoru bude bez uvedení prostoru.[[foto:Galerie]]
. Odkaz napříč jmennými prostory. Musí být uveden se jménem prostoru.[[wiki:Help]]
. Odkaz napříč jmennými prostory. Musí být uveden se jménem prostoru.[[: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.