====== Пространства имен ======

В [[start|DokuWiki]] вы можете использовать так называемые "Пространства имен" или "Именные пространства" для упорядочивания ваших страниц.(( На сервере, который обслуживает DokuWiki, пространство имен - это обычная директория в которой находятся текстовые файлы - страницы DokuWiki.))

===== Создание пространства имен =====

Для создания пространств имен не нужно предпринимать каких-то специальных действий: просто используйте двоеточие '':'' в [[pagename|названиях страниц]]. Часть названия после последнего двоеточия станет названием страницы (файла), а все, что находится до, станет именным простанством (последовательностью вложенных директорий). Если такого именого пространства еще нет, оно создастся автоматически.

^Ссылка^ указывает на страницу (файл) "example" ^
|example\\ .example\\ .:example|в **текущем** именном простанстве.|
|:example|в **корневом** именном пространстве.|
|..example\\ ..:example\\ .:..:example|в **родительском** именном пространстве (директории на уровень выше)|
|wiki:example|  в именном пространстве "wiki". Именное пространство "wiki"  **вложено в корневое** именное пространство.|

|ns1:ns2:example\\ :ns1:ns2:example| страница "example" находится в именном пространстве "ns2". Пространство "ns2" расположено в пространстве "ns1", которое, в свою очередь, лежит в корневом именном пространстве.|
|.ns1:ns2:example\\ .:ns1:ns2:example| страница "example" находится в именном пространстве "ns2". Пространство "ns2" расположено в пространстве "ns1", лежащем, в свою очередь, в текущем именном пространстве.|
|.ns1:ns2:|ссылается на страницу "start" в именном пространстве "ns2". Именное пространство "ns2" расположено в  именном пространстве "ns1", лежащем, в свою очередь, в текущем именном пространстве.((Страница по умолчанию может называться не только "start", для этого надо указать нужное значение в [[doku>config|настройках DokuWiki#start]]))|

===== Удаление  пространства имен =====

Если все страницы внутри пространства имен удалены, это пространство имен логически перестает существовать. [[start|DokuWiki]] обычно удаляет соответствующую ему пустую директорию.


===== Как переименовать пространство имен? =====

Для перемещения каждой из страниц из старого пространства имен в новое вы можете использовать плагин  [[doku>plugin:pagemove|PageMove]]. Ознакомьтесь с документацией, чтобы понять, соответствует ли это тому, что вам нужно.

[[doku>namespaces|Ручной способ]] гораздо более трудоемкий.

===== Ссылки на пространства имен =====

Можно задавать ссылку на файл по умолчанию для пространства имен, заканчивая ссылку двоеточием: %%[[foo:bar:]]%%. На какую страницу указывает ссылка, зависит от наличия файлов с определенными именами. Для %%[[foo:bar:]]%% проверяется существование следующих страниц:

<code>
foo:bar:$conf['start']
foo:bar:bar
foo:bar
</code>

Страницы проверяются в этом порядке и ссылка указывает на первую найденную.

~~DISCUSSION:off~~