DokuWiki

Материал из Викиреальностя
Перейти к: навигация, поиск

DokuWiki — расширяемый плагинами викидвижок, основанный на языке PHP, не требует наличия базы данных (всю информацию хранит в файлах), разрабатывался для создания и хранения различной документации к (сравнительно) небольшим проектам, полностью русифицирован (+ большинство часто используемых плагинов), принципиально везде использует кодировку UTF-8.

Русскоязычный раздел официального сайта

Русскоязычный сайт о DokuWiki

Содержание

[править] Установка

Данный викидвижок прост в установке и часто используется в локальных хостингах, однако по этой же причине зависит от иных локальных настроек, не относящихся к исправности самого движка, например, неправильных атрибутов директорий, занятых другими программами портов[1], правил доступа у фаерволлов.

  1. Загрузите последнюю версию «ДокуВики» (англ.), последняя стабильная версия — 2017-02-19e "Frusterick Manners".
  2. Прочитайте информацию о безопасности перед началом установки. Отнеситесь к этому серьёзно. Если что-то непонятно, спросите в списке рассылки (англ.).
  3. Распакуйте скачанный архив и скопируйте все файлы на веб-сервер.
  4. В браузере откройте файл install.php (для внешнего хостинга адрес httр://имя_хостинга/install.php, для локального — http://localhost/install.php), переключитесь в выпадающем списке на язык ru и следуйте инструкциям на странице. Для дополнительной информации обратитесь к странице «Инсталлятор „ДокуВики“». После настройки не забудьте удалить этот файл!!
  5. Пользуйтесь своей собственной «ДокуВики», а заодно просмотрите справочный раздел wiki: syntax на вашем сайте и руководство на официальном сайте, чтобы ознакомиться с её возможностями.

[править] Пространства имён

Фактически из-за отсутствия базы данных этот термин является синонимом «каталога» в обычной файловой системе, единственное отличие в употреблении по умолчанию двоеточия вместо слеша для определения подпапок (исправляется опциями userewrite + useslash). Таким образом, статья S:T:A:L:K:E:R имеет такую иерархию:

1 S
1 T
1 A
1 L
1 K
1 E
2 R

[править] Плагины

Плагины позволяют расширять функциональность «ДокуВики» без необходимости править исходный код ядра системы (такие исправления придётся восстанавливать после каждого обновления системы). Всего плагинов свыше восьмисот, некоторые совместимы с другими движками, по умолчанию с движком распространяются несколько обязательных плагинов, в том числе управляющий доступом к папкам и страницам для групп и отдельных пользователей acl, конфигуратор config, менеджер плагинов plugin, массовый откатчик вандалов revert, перекодировщик safefnrecode и менеджер пользователей usermanager.

Устанавливаются плагины в директорию lib/plugins/, для большинства возможны автоматическое выкачивание, распаковка и установка с помощью менеджера плагинов по ссылкам с официального сайта. Обязательно читайте предупреждения при использовании плагинов, учитывайте совместимость с версиями движка и другими плагинами, особенно, если это касается важных функций. Для сайта на внешнем хостинге полезно иметь «полигон» в виде пустой домашней копии.

[править] Темы оформления

DokuWiki имеет возможность установки множества различных тем оформления, среди которых есть и Monobook. В целом движок не особенно ориентирован на сложный дизайн, информативность для него важнее, так что любителям красот остаётся сделать свой по имеющимся образцам (возможно, потребуется некоторое знание PHP и CSS).

Для установки темы необходимо распаковать её в директорию lib/tpl и переключить в настройках опцию template. Возможность для пользователя выбрать иную тему реализована через разные плагины, например, template_switcher.

[править] Недостатки

  • Тупит на ровном месте при попытке сохранения. — Если страница большая и содержит много ссылок, индексирование путём создания файлов разумеется занимает время.
  • Несовместимость с языком разметки MediaWiki. — Движок поставляется со скриптом xls2wiki, переводящим скопированные из Excel таблицы в формат таблиц «ДокуВики» и обратно, очевидно, можно сделать это и для синтаксиса MediaWiki. А c помощью плагина bbcode разметку можно сделать ощутимо проще обоих видов викисинтаксиса.
  • Не удалось обнаружить шаблонов разметки. — В наличии как аналог infobox из MediaWiki, так и автозаполняющий шаблон.
  • Возможные проблемы с кодировкой при переносе файлов. — Плагин safefnrecode поставляется с движком.
  • Уязвимость страниц вики. — Плагины acl и revert поставляются с движком, плагин captcha имеет пять вариантов капчи, в том числе звуковую и figlet, также есть плагин ipban для блокировки по IP, имеется wordblock фильтр. На закуску — привычный плагин ReCaptcha.

Движок не предназначен для крупных высоконагруженных сайтов без соответствующего увеличения мощности процессора и надёжности винчестеров, так как индексирование ведётся в мелких файлах, согласно принципам кластерного строения файловых систем занимающих место, кратное величине кластера, то есть большее, чем размер информации в них.

[править] Примечания

  1. В Скайпе необходимо отключать прослушивание 80-го порта, это самая сложнодиагностируемая причина
DokuWiki относится к темам: