====== Установка DokuWiki ======
<callout icon="true" type="info" title="Материал основан на следующих ресурсах:">
[[https://www.youtube.com/watch?v=kirVorhmPy4]]
[[https://wiki.rtzra.ru/wiki/dokuwiki-nice-and-easy]]
</callout>
====== Общая информация ======
Прочитать информацию о DokuWiki можно здесь: [[dokuwiki|DokuWiki]]
====== Пошаговая установка ======
В качестве базового образа для развертывания DokuWiki будем использовать: [[https://hub.docker.com/r/bitnami/dokuwiki]].
===== Шаг 1 =====
Создаем необходимые директории для DokuWiki на сервере.

Для примера создадим для этого папку **//dokuwiki_data//** по пути **//~/app/dokuwiki/dokuwiki_data//** следующей командой:
<code bash>~/app/dokuwiki> mkdir dokuwiki_data</code>
===== Шаг 2 =====
Создаем файл docker-compose.yml:
<code bash>vi docker-compose.yml</code>
<accordion>
<panel type="primary" title="Примерное содержимое файла:">
<code yaml>
version: '2'

services:
  dokuwiki:
    image: docker.io/bitnami/dokuwiki:latest
    container_name: dokuwiki #имя контейнера
    environment:
      - DOKUWIKI_USERNAME=login #указать логин для входа
      - DOKUWIKI_PASSWORD=password #указать пароль для входа
      - DOKUWIKI_EMAIL=email #указать почту для пользователя
    ports:
      - '8080:8080' #указать порт для проброса http
      - '8443:8443' #указать порт для проброса https
    volumes:
      - /path/to/data:/bitnami/dokuwiki #./dokuwiki_data

volumes:
  dokuwiki_data:
    driver: local
</code>
</panel>
</accordion>
Запускаем контейнер:
<code bash>docker-compose up -d</code>
===== Шаг 3 =====
Теперь необходимо перейти в браузере по адресу сервера с указанием порта из docker-compose.yml. Если всё сделано правильно, можно увидеть стартовую страницу DokuWiki. Для входа нужно воспользоваться логином и паролем также указанными в docker-compose.yml.
====== Настройка DokuWiki ======
===== Установка и настройка Bootstrap 3 =====
  * Элемент ненумерованного спискаПереходим Управление -> Управление дополнениями
    * Элемент ненумерованного списка* В "Установленные плагины" устанавливаем плагин **Indexmenu Plugin**
    * Элемент ненумерованного списка* В "Установленные шаблоны" устанавливаем шаблон **Bootstrap3 Template Giuseppe Di Terlizzi**

  * Создаем в корне dokuwiki страничку с именем **sidebar.txt** (в файловой системе он лежит в папке data/pages) и следующим содержимым: 
<code>{{indexmenu>..#1|js#thread navbar nsort tsort}}

~~NOCACHE~~</code>

  * Элемент ненумерованного спискаПереходим Управление -> Настройки вики
    * Элемент ненумерованного списка* В разделе "Параметры «ДокуВики»" устанавливаем:
      * template / Шаблон: **bootstrap3**
      * sidebar / Боковая панель, пустое поле отключает боковую панель: **sidebar**
    * В разделе "Параметры плагинов" -> Indexmenu устанавливаем скрываемые страницы:
      * plugin»indexmenu»skip_file / Список страниц для пропуска: **/^sidebar$/**

  * В разделе "Параметры шаблонов" -> Bootstrap3 ставим галочки по желанию для изменения внешнего вида, подключения тем, включения/отключения функций на панели навигации и т.д. Из функционального:
      * tpl»bootstrap3»showCookieLawBanner / Display the Cookie Law banner on footer: **выкл**
      * tpl»bootstrap3»fixedTopNavbar / Зафиксировать панель навигации сверху: **вкл**
      * tpl»bootstrap3»fluidContainer / Разрешить плавающий контейнер(страница во весь экран): **вкл**
      * tpl»bootstrap3»fluidContainerBtn / Display a button in navbar to expand container: **вкл**
      * tpl»bootstrap3»pageOnPanel / Включить рамку вокруг страницы: **вкл**
      * tpl»bootstrap3»tableFullWidth / Разрешить таблицы в 100% ширину: **вкл**

===== Настройки =====
  * Параметры «Докувики» / Параметры отображения / Первый заголовок вместо имени страницы (useheading) - Только в навигации
  * Indexmenu / Скрывать заглавные страницы (hide_headpage) - Отключено
====== Полезные плагины для Dokuwiki ======
<callout icon="true" type="info" title="Материал основан на следующем ресурсе:">
[[https://wiki.rtzra.ru/wiki/dokuwiki-top-plugins]]
</callout>
===== Add New Page =====
Плагин добавления новой страницы.
===== Bootstrap Wrapper Plugin =====
Дополнительные возможности для оформления текста страниц.
<note>Посмотреть описание всех возможностей плагина по оформлению можно найти здесь: 
[[https://www.lotar.altervista.org/wiki/wiki/plugin/bootswrapper]]
</note>
===== EditTable plugin =====
Исключительно удобный инструмент для работы с таблицами.
===== Move plugin =====
Переименование и перемещение страниц и файлов

Переименовать страницу: открываем на редактирование, в меню справа выбираем «Переименовать страницу», вводим новое название.

Перемещение: открываем на редактирование, в меню последовательно открываем Инструменты / Управление / Перемещение страниц и пространств имён (или Управление / Перемещение страниц и пространств имён - в зависимости как у вас настроено меню шаблона), убедимся что включено «Переместить страницу» и в поле «Новое название» пишем куда должна быть перемещена страница (пространство имен), нажимаем «Начать», при необходимости убедиться что все верно нажимаем «Просмотреть ожидаемые изменения» и если все ок - нажимаем «Начать».
===== Note Plugin =====
Симпатичные заметки.
===== XBR Plugin =====
Позволяет делать привычные переносы строк.
====== FAQ ======
<accordion>
<panel type="info" title="Отключение регистрации пользователей">
<note>[[https://www.dokuwiki.org/faq:regdisable]]</note>
Просто отключите действие регистрации в диспетчере конфигурации **//disabledactions//**.
</panel>
</accordion>