Общие сведения
Файловая система
В DokuWiki тексты статей хранятся в обычной файловой системе, соответственно, их можно группировать в папки и подпапки. Это позволяет спокойно создавать одноимённые страницы и папки на каких угодно уровнях. Например /a/bb/ccc
и /a/ccc
(одноимённые страницы разных уровней отмечены звёздочками):
корень ├── папка «a» … ├── папка «bb» │ ├── *страница «ccc» │ ├── *страница «ccc»
Второй пример, /a/bb/ccc
и /a/bb
(одноимённые папка и страница одного уровня отмечены звёздочками):
корень ├── папка «a» … ├── *папка «bb» │ ├── страница «ccc» │ ├── *страница «bb»
Посмотреть всю структуру сайта. Единственное отличие - помимо разделителя папок слэш «/
» можно использовать двоеточие «:
», и даже вперемешку; они равнозначны по смыслу.
Адресация
Начальный слеш в адресе означает, что он полный, указывает путь от самой корневой папки сайта. Это полезно, когда нужно сослаться на страницу в другом разделе или возникает «проблема одноимённости». Полный адрес текущей страницы всегда отображается в нижнем левом углу сайта (через родное «двоеточие» и без «корня»).
Эта страница имеет полный путь «от корня» /wiki/1namespaces
, главная справки - /wiki/index
, главная страница сайта - /start
В случае соседнего расположения ссылку можно укоротить до текущего уровня.
Эта страница адресуется 1namespaces
, а главная страница справки - index
Можно использовать относительную адресацию (родительская папка обозначается как ../
, её родительская - как ../../
и т.д., текущая папка - ./
)
Главная страница сайта относительно этой страницы адресуется ../start
, а главная страница справки - ./index
Ограничения имён
Имена страниц автоматически преобразуются в нижний регистр, кириллица переводится в длинные URL-коды, поэтому кириллические имена длиннее 15 знаков нежелательны, хотя в целом хорошо поддерживаются. Допустимыми для имени символами являются буквы, цифры, а ещё точка «.
», дефис «-
» и подчёркивание «_
», в который будут преобразованы все остальные спецсимволы. Если последние три поставлены в начале или конце имени, они будут убраны, если их несколько подряд - сведены к одному. Слэш «/
» и двоеточие «:
» зарезервированы, как разделители папок.