======  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''

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

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ě''

<code>
  * [[diskuze]] odkazuje na ''wiki:diskuze''
  * [[diskuze:o životě]] odkazuje na ''diskuze:o životě''
  * [[.diskuze:o životě]] odkazuje na ''wiki:diskuze:o životě''
</code>

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.