Это старая версия документа!
Содержание
Разработка шаблонов DokuWiki
Вы можете менять дизайн DokuWiki по своему усмотрению, создав новый шаблон, который представляет собой несколько PHP и CSS файлов, сохраненных в каталоге и помещенных в <dokuwiki>/lib/tpl/
(в действительности, шаблон написан на HTML, а PHP используется только для вставки контента).
Начало работы
Проще всего создать новый шаблон, взяв в качестве отправной точки уже существующий. Лучше всего подойдет шаблон default, так как он содержит все необходимые части шаблона и следует стандартам составления шаблонов DokuWiki. Имена шаблонов (директорой) следует писать в нижнем регистре без символов точки и подчеркивания.
- Скопируйте стандартный шаблон lib/tpl/default в директорию, где будет хранится Ваш шаблон, например lib/tpl/mytemplate
- Выберите новый шаблон на странице «Управление»
- Ознакомьтесь с файлами шаблона (см. Структура каталогов)
- Посмотрите как DokuWiki обрабатывает CSS с помощью диспетчера CSS
- Обработка конфигурационных параметров аналогична плагинам. Используйте
tpl_getConf(<setting>)
для получения параметров шаблона.
Структура каталогов
Шаблоны должны иметь следующую структуру директорий (все пути указаны относительно каталога шаблона). Файлы CSS определены в style.ini
, но вам следует предоставить как минимум два файла: один основной, другой для вывода на печать.
<dokuwiki>/lib/tpl/<template>/
<filename>.css
main.php
– главный файл разметки шаблона DokuWikidetail.php
– страница подробного описания изображенияmediamanager.php
– мультимедия загрузчикimages/
– все используемые в шаблоне изображенияconf/
lang/
– языковые файлы<код языка>/lang.php
– локализованные строки, используемые в шаблоне<код языка>/settings.php
– локализованные строки, используемые на странице настроек DokuWiki
style.ini
– см. Style.ini
Функции
Список доступных функций вы можете найти здесь: API documentation. Самые важные приведены ниже.