Содержание

🙂 Делаем Dokuwiki красивой и удобной

🙂 Делаем Dokuwiki красивой и удобной

Ответы на часто задаваемые вопросы

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

Бесплатно

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

Платно

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

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

Что для этого нужно:

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

По окончании работ вы ОБЯЗАТЕЛЬНО должны:

Самостоятельно сменить пароли на вашем хостинге
Проверить и удалить все аккаунты в Dokuwiki, за исключением вашего административного аккаунта
Сменить пароль вашего аккаунта Dokuwiki

Установка 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) и следующим содержимым:
```
{{indexmenu>..#1|js#thread navbar nsort tsort noscroll}}

~~NOCACHE~~
```

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

Переходим Управление → Настройки вики
- В разделе «Параметры «ДокуВики»» устанавливаем:
  - 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

Если стандартная тема сайдбара не нравится, изменяем ее легко и просто: в строке

{{indexmenu>..#1|js#thread navbar nsort tsort}}

кусочек #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

Было:

        switch ($type) {
            case 'left':
 
                if ($this->getConf('sidebarPosition') == 'left') {
                    $this->sidebarWrapper($left_sidebar, 'dokuwiki__aside', $left_sidebar_grid, 'sidebarheader', 'sidebarfooter');
                }
 
                return true;

Стало:

        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;

Меняем лого и favicon

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

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

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

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

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

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

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

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

~~NOCACHE~~
```

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

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

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