Настройка dokuwiki

Немножно технических развлечений …
Простейшая и очень качественная система. Понравилась мне гораздо больше знаменитой MediaWiki.
Один из самых больших плюсов (для меня) — прозрачность хранения данных.
Все данные лежат в обычных текстовых файлах, в отдельной папке. Их можно просто скопировать и перенести на новое место.
И редактировать тоже можно любым редактором, не обязательно встроенными средствами wiki.
Но вот есть у dokuwiki некоторые проблемы с разметкой. Вкратце — разметка у неё немного своя. Поэтому я, как любитель формата markdown, решил постараться добиться того, чтобы исходные текстовые файлы были как можно более универсальны.
Вначале подключаем формат markdown. Для этого, если копнуть интернет, есть три плагина:
markdown;
markdownextra;
markdowku.
Нам необходим только последний. Первые два являются уже устаревшими.
Устанавливаем плагин и активируем.
Вторая задача по нормальному отображению текста — это перенос строк.
Для этого также есть несколько плагинов, но наиболее корректный, и без дополнительных тегов в тексте, это
XBR.
Но его нужно еще дополнительно включить следующим образом:
Заходим в «Настройки»:
http://<вашсайт>/doku.php?id=start&do=admin&page=config
Находим параметр «Обработчик основного (xhtml) вывода вики», который выглядит вот так:
dokuwiki-xbr-on
И переключаем его на XBR.
Теперь мы можем подкладывать в папку с данными любые текстовые файлы в формате Markdown и с расширением .txt и они будут корректно отображаться в dokuwiki.
Единственное их отличие от обычных файлов будет в ссылках на медиафайлы и другие страницы wiki.

И еще, дополнительные замечания по именованию и содержимому файлов:
1) Используйте латинские именования файлов. То есть, создавая новую страницу, пишите название только латиницей. Это, во-первых, эстетичнее, чем имя «%20%67%45», а во вторых, допустимы более длинные названия (общая длина ограничена 255 символов).
2) Поставьте параметр в файле dokuwiki.php $conf[‘useheading’] = 1. Тогда, несмотря на латинское название файла, страница будет называться так, как указано в первом заголовке H1 (====== заголовок ======) — с шестью знаками «равно» с каждой стороны (это родной формат dokuwiki). Заголовок рекомендуется в каждом файле в начале.
Если уже активирован XBR, то заголовок, в соответствии с форматом Markdown, будет иметь формат

Заголовок
=========
.

p.s.
Кстати, Dokuwiki можно запускать локально. Для этого при скачивании с официального сайта, укажите признак
Include Web-Server
MicroApache (Windows)
.
Запускаете run.bat — стартует dokuwiki. Работает даже без административных прав.

p.p.s.
Для снятия резервной копии достаточно скопировать:
1) Папку /data/pages (тут текст);
2) Папку /data/media (тут картинки и т.п. медиа);
3) Файл /conf/users.auth/php (тут пользователи).

Добавить комментарий

Ваш e-mail не будет опубликован.