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

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

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

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

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

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

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

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

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

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

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

  • Обновляем (или устанавливаем) Dokuwiki последней версии (на момент написания данного руководства это 2015-08-10 «Detritus»)
  • Переходим Управление → Управление дополнениями
    • В «Установленные плагины» устанавливаем плагин 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) - Отключено

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

{{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 зеленого цвета. Чтобы изменить цвет на ваш любимый открываем Управление → Настройка стилей шаблона и меняем existing на #337ab7 (синий цвет), и нажимаем «Сохранить изменения»

  • Заходим в «Управление медиафайлами»
  • Выбираем каталог «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$/
  • https://starmaugli.ru/dokuwiki/start - Автором нарыто много полезных вещей, оказывается я ему немного помогал в освоении Dokuwiki
  • Обновляем (или устанавливаем) 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$/
  • wiki/dokuwiki-nice-and-easy.txt
  • Последнее изменение: 2024/01/02 13:50
  • fireball