Пространства имён (namespaces)

DokuWiki поддерживает так называемые пространства имён для отделения различного контента в wiki. Например вся информация о DokuWiki находится в пространстве имён wiki. Пространства имён задаются дперед двоеточием в имени страницы pagename. Кроме того вы можете использовать точку с запятой и – если параметр useslash включен – то и косую черту ( / )как разделитель пространства имен.

пример
namespace:pagename

Если нет двоеточия в ссылке на имя страницы, подразумевается текущее пространство имён. Вы можете Вы можете покинуть начальное пространство имён изменив его перед двоеточием в адресе ссылки. Вот несколько примеров:

• start ведёт к wiki:start
• start ведёт к wiki:start
• start ведёт к start

  * [[wiki:start]] ведёт к ''wiki:start''
  * [[start]] ведёт к ''wiki:start''
  * [[:start]] ведёт к ''start''

Иногда вам может понадобиться дать ссылку на подпространство имён без указания полного адреса пространства имён (например если у него слишком длинное название). Вы можете начать написание ссылки с точки (.) что всегда означает текущее пространство имён. Снова несколько примеров:

• discussion приведёт к wiki:discussion
• visibility приведёт к discussion:visibility тоесть сменит пространство имён
• visibility приведет к wiki:discussion:visibility - тоесть к подпространству пространства wiki

  * [[discussion]] приведёт к ''wiki:discussion''
  * [[discussion:visibility]] приведёт к ''discussion:visibility'' тоесть сменит пространство имён
  * [[.discussion:visibility]] приведет к ''wiki:discussion:visibility'' - тоесть к подпространству пространства wiki

Пространства имён помогают категоризировать и структурировать контент.

Можно использовать их чтобы отдеолить контент об одном субьекте от другого несвязанного контента. Это разделение присутствует в 2-х уровнях: хранение и связи (ссылки).

• Хранение - пространства имён хранятся как папки в файловой системе. Это помогает содержать контент об одном субьекте внутри одной папки, в виде простых текстовых файлов. Администраторам очень удобно работать с обычными текстовыми файлами. Например: чтобы произвести резервное копирование всего проекта XYZ ⇒ нужно всего лишь сохранить папку проектXYZ/*.txt (со всеми текстовыми файлвми).
• Ссылки - пространство имён это префикс <name:> перед каждым именем страницы. Обычный текстовый файл с контентом для этой страницы сохраняется внутри папки <name>, и будет при просмотре документов этого пространства имён, может ссылаться на все документы этого пространства имён без указания префикса <name:>. Этот префикс необходим только в случае когда ссылаются извне <name> (из другого пространства имён) на страницы внутри него.

Примечание: страницы и документы эти оба понятия - одно и то же: документ с контентом = HTML страница.