Содержание
Шаблон DokuWiki
Совместим с «Докувики»
(bundled)
Это расширение не обновлялось более двух лет. Возможно, оно больше не разрабатывается или не поддерживается; возможны проблемы совместимости.
Похож на adoradark
Это новый шаблон по умолчанию, входящий в состав DokuWiki с момента выхода «Adora Belle» (выпуск 13.10.2012)
Шаблон был разработан Clarence Lee. Подробнее об истории шаблона читайте здесь.
Функции
- Дополнительная боковая панель
- Поддержка мобильных устройств (размеры ПК, планшетов, телефонов)
- HTML5-совместимый
Настройка
Шаблон поддерживает простую настройку. Если вам нужно больше, чем это, вам следует создать свой собственный шаблон. Проверьте DokuWiki Template Development for that.
Добавление боковой панели
Шаблон поддерживает боковую панель, настроенную в Параметре конфигурации: боковая панель.
Изменение ширины и других стилей
Помимо стандартных гарантированных заполнителей style.ini шаблон использует следующие переменные:
переменная-заполнитель | значение |
---|---|
__background_site__ | фоновый цвет всего сайта |
__link__ | цвет ссылок |
__existing__ | цвет ссылок на существующие внутренние страницы |
__missing__ | цвет ссылок на отсутствующие внутренние страницы |
__site_width__ | ширина всего сайта |
__sidebar_width__ | ширина боковой панели |
Например, вы можете настроить ширину шаблона, переопределив переменную __site_width__
Просто создайте файл conf/tpl/dokuwiki/style.ini
(или старое местоположение: lib/tpl/dokuwiki/style.local.ini
in Adora Belle) и установите переменную соответствующим образом. Вы можете использовать фиксированное значение (px или em) или процентное значение (%), если вы предпочитаете динамическую ширину.
- conf/tpl/dokuwiki/style.ini
[replacements] __site_width__ = "100%"
Вы также можете использовать этот файл для переопределения любой другой переменной из style.ini.
Например, для изменения некоторых цветов.
Изменение логотипа
Значки Logo, Favicon и Apple Touch (закладка) ищутся в нескольких местах. Значки по умолчанию (логотип DokuWiki), предоставляемые шаблоном, можно легко заменить, загрузив файлы изображений в правильные места с помощью Media Manager popup или Fullscreen Media Manager.
Вот местоположения, проверяемые кодом шаблона:
- Логотип сайта
:wiki:logo.svg
:logo.svg
:wiki:logo.png
:logo.png
lib/tpl/dokuwiki/images/logo.png
- Фавикон
:wiki:favicon.ico
:favicon.ico
lib/tpl/dokuwiki/images/favicon.ico
- Значок закладки, используемый на устройствах Apple и Android
:wiki:apple-touch-icon.png
:apple-touch-icon.png
lib/tpl/dokuwiki/images/apple-touch-icon.png
Пожалуйста, убедитесь, что эти пространства имен (либо root, либо wiki:
) или доступны для чтения всем пользователям. В противном случае изображение будет повреждено для пользователей, которые не вошли в систему.
См. также: Логотип DokuWiki
Крючки для действий
Плагины могут интегрироваться в шаблон без необходимости его изменения, предоставляя компонент Action для обработки пользовательских обработчиков действий, запускаемых шаблоном
TEMPLATE_PAGETOOLS_DISPLAY
Это событие позволяет расширить или изменить плавающее меню pagetools. $event->data['items']
содержит массив с HTML для каждого элемента в меню. Авторы плагинов должны соответствовать существующему стилю и предоставить необходимый CSS и фоновое изображение. Вы можете использовать различные стили или классы или разметку в зависимости от $conf['template']
. $event->data['view']
содержит информацию о том, вызываются ли pagetools в main или detail
представлении.
Поддерживаемые Include-хуки
Включаемые хуки позволяют добавлять дополнительный HTML или PHP в шаблон без изменения каких-либо файлов шаблона, что делает их безопасными для обновления. Просто создайте соответствующий файл либо в каталоге шаблона (lib/tpl/dokuwiki/
) либо в вашем conf/
каталоге.
Имя файла | Положение включенного HTML |
---|---|
meta.html | Внутри HTML-тега <head> используйте это для добавления дополнительных стилей или метазаголовков. |
sidebarheader.html | В верхней части боковой панели (если есть) |
sidebarfooter.html | Внизу боковой панели (если есть) |
pageheader.html | В верхней части внутри поля контента, над самим контентом |
pagefooter.html | Внизу внутри поля содержимого, под самим содержимым |
header.html | В верхней части страницы, над логотипом и заголовком вики |
footer.html | В самом конце страницы после всего остального содержимого страницы |