Шаблон DokuWiki по умолчанию с 2012 года

Совместим с «Докувики»
(bundled)
Это расширение не обновлялось более двух лет. Возможно, оно больше не разрабатывается или не поддерживается; возможны проблемы совместимости.
Это новый шаблон по умолчанию, входящий в состав DokuWiki с момента выхода «Adora Belle» (выпуск 13.10.2012)
Шаблон был разработан Clarence Lee. Подробнее об истории шаблона читайте здесь.
На GitHub: https://github.com/dokuwiki/dokuwiki/tree/master/lib/tpl/dokuwiki
Шаблон поддерживает простую настройку. Если вам нужно больше, чем это, вам следует создать свой собственный шаблон. Проверьте 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) или процентное значение (%), если вы предпочитаете динамическую ширину.
[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.pnglib/tpl/dokuwiki/images/logo.png:wiki:favicon.ico:favicon.icolib/tpl/dokuwiki/images/favicon.ico:wiki:apple-touch-icon.png:apple-touch-icon.pnglib/tpl/dokuwiki/images/apple-touch-icon.png
Пожалуйста, убедитесь, что эти пространства имен (либо root, либо wiki:) или доступны для чтения всем пользователям. В противном случае изображение будет повреждено для пользователей, которые не вошли в систему.
См. также: Логотип DokuWiki
Плагины могут интегрироваться в шаблон без необходимости его изменения, предоставляя компонент Action для обработки пользовательских обработчиков действий, запускаемых шаблоном
Это событие позволяет расширить или изменить плавающее меню pagetools. $event->data['items'] содержит массив с HTML для каждого элемента в меню. Авторы плагинов должны соответствовать существующему стилю и предоставить необходимый CSS и фоновое изображение. Вы можете использовать различные стили или классы или разметку в зависимости от $conf['template']. $event->data['view'] содержит информацию о том, вызываются ли pagetools в main или detail представлении.
Включаемые хуки позволяют добавлять дополнительный HTML или PHP в шаблон без изменения каких-либо файлов шаблона, что делает их безопасными для обновления. Просто создайте соответствующий файл либо в каталоге шаблона (lib/tpl/dokuwiki/) либо в вашем conf/ каталоге.
| Имя файла | Положение включенного HTML |
|---|---|
meta.html | Внутри HTML-тега <head> используйте это для добавления дополнительных стилей или метазаголовков. |
sidebarheader.html | В верхней части боковой панели (если есть) |
sidebarfooter.html | Внизу боковой панели (если есть) |
pageheader.html | В верхней части внутри поля контента, над самим контентом |
pagefooter.html | Внизу внутри поля содержимого, под самим содержимым |
header.html | В верхней части страницы, над логотипом и заголовком вики |
footer.html | В самом конце страницы после всего остального содержимого страницы |