====== Шаблон DokuWiki ======

---- template ----
description   : Шаблон DokuWiki по умолчанию с 2012 года
author        : Anika Henke
email         : anika@selfthinker.org 
lastupdate    : 2014-06-04
compatible    : (bundled)
similar       : 
downloadurl   : https://github.com/dokuwiki/dokuwiki/tree/master/lib/tpl/dokuwiki
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|Ссылка на оригинальную статью]]