Инструменты пользователя
Пространства имён (namespaces)
DokuWiki поддерживает так называемые пространства имён для отделения различного контента в wiki. Например вся информация о DokuWiki находится в пространстве имён wiki
. Пространства имён задаются дперед двоеточием в имени страницы pagename. Кроме того вы можете использовать точку с запятой и – если параметр useslash включен – то и косую черту ( / )как разделитель пространства имен.
пример namespace:pagename
Если нет двоеточия в ссылке на имя страницы, подразумевается текущее пространство имён. Вы можете Вы можете покинуть начальное пространство имён изменив его перед двоеточием в адресе ссылки. Вот несколько примеров:
* [[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 страница.
Инструменты страницы