| Следующая версия | Предыдущая версия |
| template:dokuwiki [2025/02/09 15:07] – создано - внешнее изменение 127.0.0.1 | template:dokuwiki [Дата неизвестна] (текущий) – удалено - внешнее изменение (Дата неизвестна) 127.0.0.1 |
|---|
| ====== Шаблон DokuWiki ====== | |
| |
| ---- template ---- | |
| description : Шаблон DokuWiki по умолчанию с 2012 года | |
| author : Anika Henke | |
| email : anika@selfthinker.org | |
| lastupdate : 2014-06-04 | |
| compatible : (bundled) | |
| similar : | |
| screenshot_img: :wiki:template:dokuwiki_template.png | |
| tags : default, sidebar, !bundled, mobile, responsive | |
| ---- | |
| |
| Это новый шаблон по умолчанию, входящий в состав DokuWiki с момента выхода «Adora Belle» (выпуск 13.10.2012) | |
| |
| Шаблон был разработан [[clarencedglee@gmail.com|Clarence Lee]]. Подробнее [[http://blog.selfthinker.org/2012/10/20/the-story-behind-dokuwikis-new-template/|об истории шаблона читайте здесь]]. | |
| |
| ===== Функции ===== | |
| |
| * Дополнительная [[wiki:config:sidebar|боковая панель]] | |
| * Поддержка мобильных устройств (размеры ПК, планшетов, телефонов) | |
| * HTML5-совместимый | |
| |
| ===== Настройка===== | |
| |
| Шаблон поддерживает простую настройку. Если вам нужно больше, чем это, вам следует создать свой собственный шаблон. Проверьте [[wiki:devel:templates|DokuWiki Template Development]] for that. | |
| |
| ==== Добавление боковой панели ==== | |
| |
| Шаблон поддерживает боковую панель, настроенную в [[wiki:config:sidebar|Параметре конфигурации: боковая панель]]. | |
| |
| |
| ==== Изменение ширины и других стилей ==== | |
| |
| Помимо стандартных гарантированных заполнителей [[wiki:devel: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) или процентное значение (%), если вы предпочитаете динамическую ширину. | |
| |
| <code ini conf/tpl/dokuwiki/style.ini> | |
| [replacements] | |
| __site_width__ = "100%" | |
| </code> | |
| |
| Вы также можете использовать этот файл для переопределения любой другой переменной из ''style.ini.'' Например, для изменения некоторых цветов. | |
| |
| ==== Изменение логотипа ==== | |
| |
| Значки Logo, Favicon и Apple Touch (закладка) ищутся в нескольких местах. Значки по умолчанию (логотип DokuWiki), предоставляемые шаблоном, можно легко заменить, загрузив файлы изображений в правильные места с помощью [[wiki:media_manager|Media Manager popup]] или [[wiki:fullscreen mediamanager|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:'') или [[wiki:acl|доступны для чтения]] всем пользователям. В противном случае изображение будет повреждено для пользователей, которые не вошли в систему. | |
| |
| **См. также:** [[wiki:logo|Логотип DokuWiki]] | |
| |
| ==== Крючки для действий ==== | |
| |
| Плагины могут интегрироваться в шаблон без необходимости его изменения, предоставляя [[wiki:devel:action_plugins|компонент Action]] для обработки пользовательских обработчиков действий, запускаемых шаблоном | |
| |
| === TEMPLATE_PAGETOOLS_DISPLAY === | |
| |
| Это [[wiki:devel:event:TEMPLATE_PAGETOOLS_DISPLAY|событие]] позволяет расширить или изменить плавающее меню pagetools. ''%%$event->data['items']%%'' содержит массив с HTML для каждого элемента в меню. Авторы плагинов должны соответствовать существующему стилю и предоставить необходимый CSS и фоновое изображение. Вы можете использовать различные стили или классы или разметку в зависимости от ''$conf['template']''. ''%%$event->data['view']%%'' содержит информацию о том, вызываются ли pagetools в <del>main</del> или ''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: | |
| [[https://github.com/dokuwiki/dokuwiki/tree/master/lib/tpl/dokuwiki|{{fa>github-square?24|Icons DokuWiki plugin on GitHub}}]] | |
| |
| ====Дополнения и Файлы==== | |
| * {{ :wiki:template:dokuwiki.rar |Шаблон DokuWiki по умолчанию}} | |
| [[https://www.dokuwiki.org/template:dokuwiki|Ссылка на оригинальную статью]] | |
| |
