Инструменты пользователя

Инструменты сайта


wiki:template:dokuwiki

Шаблон DokuWiki

Совместим с «Докувики»

(bundled)

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

Последнее обновление:
2014-06-04

Отсутствующий URL-адрес загрузки означает, что это расширение невозможно установить через диспетчер расширений. Пожалуйста, посмотрите Publishing a Plugin on dokuwiki.org. Рекомендуется использовать хосты общедоступных репозиториев, такие как GitHub, GitLab или Bitbucket.

Это расширение не обновлялось более двух лет. Возможно, оно больше не разрабатывается или не поддерживается; возможны проблемы совместимости.

Это расширение не находится в пространстве имен 'plugin' или 'template' и поэтому игнорируется.

Похож на adoradark

Теги: !bundled, default, mobile, responsive, sidebar

Это новый шаблон по умолчанию, входящий в состав 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 В самом конце страницы после всего остального содержимого страницы

на GitHub:

Дополнения и Файлы

Только авторизованные участники могут оставлять комментарии.
wiki/template/dokuwiki.txt · Последнее изменение: 2025/02/09 15:07 — vladpolskiy