🙂 Делаем Dokuwiki красивой и удобной [RTzRa's hive]

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
====== 🙂 Делаем Dokuwiki красивой и удобной ======

<callout title="Ответы на часто задаваемые вопросы" type="success">

Ниже описывается как своими силами доделать Dokuwiki от вида "из коробки" до примерно того что вы видите на этом сайте. Это не сложно, но при первой установке могут понадобиться некоторые знания.

===== Бесплатно ======

Если у вас есть вопросы по настройке или возможностях dokuwiki - можно задать их мне (на главной страничке есть мои координаты). Постараюсь ответить по мере возможности, будьте терпеливы.

===== Платно =====

Если вам некогда разбираться, я могу проделать эту работу за небольшое вознаграждение, размер которого зависит от ваших хотелок и потраченного времени. Уточнение: дизайном я НЕ занимаюсь!

Время на установку и приведение в божеский вид: от 1 часа в зависимости от объема работы, скорости работы вашего хостинга и т.д.

Что для этого нужно:
  * ВЫ: Связыватесь со мной: [[:start|Контакты]]
  * ВЫ: Отправляете понятное описание что должно быть на выходе
  * Я: Уточняю возможность/сроки/деньги
  * ВЫ: Предоставляете логин/пароль от вашего хостинга с доступом по SSH (в крайнем случае FTP)
  * Я: Выполняю работу
  * ВЫ: Ожидаете выполнения работ
  * ВЫ: Проверяете результат

По окончании работ вы ОБЯЗАТЕЛЬНО должны:
  * Самостоятельно сменить пароли на вашем хостинге
  * Проверить и удалить все аккаунты в Dokuwiki, за исключением вашего административного аккаунта
  * Сменить пароль вашего аккаунта Dokuwiki
 
</callout>

===== Установка Dokuwiki =====

  * Скачать можно тут: https://download.dokuwiki.org/
  * Используйте только Stable версию
  * Инструкция по установке: https://www.dokuwiki.org/install
  * Настройка безопасности: https://www.dokuwiki.org/security
  * Настройка красивых URL: https://www.dokuwiki.org/rewrite

==== Красивый и моднявый Bootstrap3 ====

После выполнения этих действий dokuwiki станет похожей на мою

  * Обновляем (или устанавливаем) Dokuwiki последней версии
  * Переходим Управление -> Управление дополнениями
    * В "Установленные плагины" устанавливаем плагин **Indexmenu Plugin**
    * В "Установленные шаблоны" устанавливаем шаблон **Bootstrap3 Template Giuseppe Di Terlizzi**
  * Создаем в корне dokuwiki страничку с именем **sidebar.txt** (в файловой системе он лежит в папке data/pages) и следующим содержимым: <code>{{indexmenu>..#1|js#thread navbar nsort tsort noscroll}}

~~NOCACHE~~</code>
<code>Расшифровка магии:
{{indexmenu>..:#1}} - Отображать пространство имен родителя и текущий уровень, не разворачивать ноды
js#thread - использовать JS, тема "thread"
navbar - Разворачивать дерево текущего неймспейса
nsort tsort - сортировка страниц в алфавитном порядке
nomenu - используйте если нужно скрывать всплывающее меню
noscroll - если нужно отключить скроллер (если надпись не входит в ширину indexmenu, будет возможность ее двигать и не всем это нравится)
Все параметры тут: https://www.dokuwiki.org/plugin:indexmenu#full_syntax
</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) - Отключено

===== Изменяем тему sidebar =====
Если стандартная тема сайдбара не нравится, изменяем ее легко и просто: в строке <code>{{indexmenu>..#1|js#thread navbar nsort tsort}}</code> кусочек **#thread** как раз и указывает какую тему использовать. В стандартной поставке есть следующие темы (лежат в папке lib/plugins/indexmenu/images): bj-tango.png, dryoo.png, kde.png, prdsuser-de.png, thread2, bj_ubuntu.png, kgs, bw.png, gnome.png, repository, vista.png, human.png, leopard.png, shiki_brave.png, default, simple, doku, indextheme, pcc_dotted, tango.png, drktheme, kde, phoenity.png, thread

===== Изменяем цвет sidebar =====
По умолчанию sidebar зеленого цвета. Чтобы изменить цвет на ваш любимый открываем Управление -> Настройка стилей шаблона и меняем __existing__ на #337ab7 (синий цвет), и нажимаем "Сохранить изменения"

===== Как сделать sidebar видимым только для пользователей с правом "Правка" или выше =====
Нужно вносить изменения в шаблоне, при обновлении шаблона придется повторить. Для шаблона bootstrap3 нужно отредактировать файл lib/tpl/bootstrap3/Template.php

Было:
<code php>
        switch ($type) {
            case 'left':

                if ($this->getConf('sidebarPosition') == 'left') {
                    $this->sidebarWrapper($left_sidebar, 'dokuwiki__aside', $left_sidebar_grid, 'sidebarheader', 'sidebarfooter');
                }

                return true;
</code>

Стало:
<code php>
        switch ($type) {
            case 'left':
                if (auth_quickaclcheck($ID) >= AUTH_EDIT) {

                    if ($this->getConf('sidebarPosition') == 'left') {
                        $this->sidebarWrapper($left_sidebar, 'dokuwiki__aside', $left_sidebar_grid, 'sidebarheader', 'sidebarfooter');
                    }
                  }

                return true;
</code>

===== Меняем лого и favicon =====
  * Заходим в "Управление медиафайлами"
  * Выбираем каталог "wiki"
  * Загружаем по очереди файлы logo.png и favicon.ico - это и будет замена стандартным изображениям

===== Как добавить сайдбар справа (по аналогии с левым) =====

  * Устанавливаем тему Bootstrap3 как описано выше, проверяем настройки в разделе Боковая панель (они уже должны быть по умолчанию):
    * tpl»bootstrap3»rightSidebar: rightsidebar
    * tpl»bootstrap3»rightSidebarGrid: col-sm-3 col-md-2
  * Создаем страницу rightsidebar.txt в корне вики со следующим содержимым:<code>~~NOCACHE~~</code>
  * В разделе "Параметры плагинов" -> Indexmenu устанавливаем скрываемые страницы:
      * plugin»indexmenu»skip_file / Список страниц для пропуска: **/^sidebar$|^rightsidebar$/**

===== Дополнительные интересные страницы по настройке Dokuwiki =====

  * https://starmaugli.ru/dokuwiki/start - Автором нарыто много полезных вещей, оказывается я ему немного помогал в освоении Dokuwiki

===== Устаревшая информация =====

==== Классический способ настройки indexmenu [УСТАРЕЛО] ====

  * Обновляем (или устанавливаем) Dokuwiki последней версии
  * Переходим Управление -> Управление дополнениями
    * В "Установленные плагины" устанавливаем плагин **Indexmenu Plugin**
  * Создаем в корне dokuwiki страничку с именем **sidebar** (полное имя **sidebar.txt** если создаете страничку при помощи любого редактора, в файловой системе он лежит в папке data/pages) и следующим содержимым: <code>{{indexmenu>..#1|js#thread navbar nsort tsort noscroll}}

~~NOCACHE~~</code>
<code>Расшифровка магии:
{{indexmenu>..:#1}} - Отображать пространство имен родителя и текущий уровень, не разворачивать ноды
js#thread - использовать JS, тема "thread"
navbar - Разворачивать дерево текущего неймспейса
nsort tsort - сортировка страниц в алфавитном порядке
noscroll - если нужно отключить скроллер (если надпись не входит в ширину indexmenu, будет возможность ее двигать и не всем это нравится)
Если нужно скрывать всплывающее меню - используйте nomenu
Все параметры тут: https://www.dokuwiki.org/plugin:indexmenu#full_syntax
</code>
  * Переходим Управление -> Настройки вики
    * В разделе "Параметры «ДокуВики»" устанавливаем:
      * template / Шаблон: **dokuwiki**
      * sidebar / Боковая панель, пустое поле отключает боковую панель: **sidebar**
    * В разделе "Параметры плагинов" -> Indexmenu устанавливаем скрываемые страницы:
      * plugin»indexmenu»skip_file / Список страниц для пропуска: **/^sidebar$/**

{{tag>dokuwiki theme themes bootstrap sidebar classic modern logo.png favicon.ico красивый_и_удобный_вид украшательства}}