| 1458765052 | current | ||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | ====== Разработка1 шаблонов «ДокуВики» ====== | + | ====== Разработка шаблонов «Докувики» ====== |
| :!: Страница нуждается в переработке. За точной информацией обращайтесь к [[devel:templates|английской версии страницы]]. :!: | :!: Страница нуждается в переработке. За точной информацией обращайтесь к [[devel:templates|английской версии страницы]]. :!: | ||
| - | Вы можете менять дизайн «[[..:dokuwiki|ДокуВики]]» по своему усмотрению, создав новый шаблон, который представляет собой несколько PHP- и CSS-файлов, сохранённых в каталоге и помещённых в ''<dokuwiki>/lib/tpl/'' (в действительности, шаблон написан на HTML, а PHP используется только для вставки контента). | + | Вы можете менять дизайн «[[..:dokuwiki|Докувики]]» по своему усмотрению, создав новый шаблон, который представляет собой несколько PHP- и CSS-файлов, сохранённых в каталоге и помещённых в ''<dokuwiki>/lib/tpl/'' (в действительности, шаблон написан на HTML, а PHP используется только для вставки контента). |
| ===== Начало работы ===== | ===== Начало работы ===== | ||
| - | Проще всего создать новый шаблон, взяв в качестве отправной точки уже существующий. Лучше всего подойдет шаблон «default», так как он содержит все необходимые части шаблона и следует стандартам составления шаблонов «ДокуВики». Название шаблона (каталога) следует писать в нижнем регистре без символов точки и подчеркивания. | + | Проще всего создать новый шаблон, взяв в качестве отправной точки уже существующий. Лучше всего подойдет шаблон «default», так как он содержит все необходимые части шаблона и следует стандартам составления шаблонов «Докувики». Название шаблона (каталога) следует писать в нижнем регистре без символов точки и подчеркивания. |
| - Скопируйте стандартный шаблон ''lib/tpl/default'' в каталог, где будет хранится ваш шаблон, например ''lib/tpl/mytemplate''; | - Скопируйте стандартный шаблон ''lib/tpl/default'' в каталог, где будет хранится ваш шаблон, например ''lib/tpl/mytemplate''; | ||
| - Выберите новый шаблон на странице «Управление»; | - Выберите новый шаблон на странице «Управление»; | ||
| - Ознакомьтесь с файлами шаблона (см. «[[templates#структура каталогов|Структуру каталогов]]»); | - Ознакомьтесь с файлами шаблона (см. «[[templates#структура каталогов|Структуру каталогов]]»); | ||
| - | - Посмотрите, как «ДокуВики» обрабатывает CSS с помощью [[..:devel:css|диспетчера CSS]]; | + | - Посмотрите, как «Докувики» обрабатывает CSS с помощью [[..:devel:css|диспетчера CSS]]; |
| - Обработка конфигурационных параметров аналогична [[common_plugin_functions|плагинам]]. Используйте ''%%tpl_getConf(<setting>)%%'' для получения параметров шаблона. | - Обработка конфигурационных параметров аналогична [[common_plugin_functions|плагинам]]. Используйте ''%%tpl_getConf(<setting>)%%'' для получения параметров шаблона. | ||
| Line 23: | Line 23: | ||
| * ''<dokuwiki>/lib/tpl/<template>/'' | * ''<dokuwiki>/lib/tpl/<template>/'' | ||
| * ''<filename>.css'' | * ''<filename>.css'' | ||
| - | * ''[[.:templates:main.php]]'' ([[devel:templates:main.php|англ.]]) --- главный файл разметки шаблона «ДокуВики» | + | * ''[[.:templates:main.php]]'' ([[devel:templates:main.php|англ.]]) --- главный файл разметки шаблона «Докувики» |
| * ''[[.:templates:detail.php]]'' ([[devel:templates:detail.php|англ.]]) --- страница подробного описания изображения | * ''[[.:templates:detail.php]]'' ([[devel:templates:detail.php|англ.]]) --- страница подробного описания изображения | ||
| * ''[[.:templates:mediamanager.php]]'' ([[devel:templates:mediamanager.php|англ.]]) --- медиаменеджер | * ''[[.:templates:mediamanager.php]]'' ([[devel:templates:mediamanager.php|англ.]]) --- медиаменеджер | ||
| Line 32: | Line 32: | ||
| * ''lang/'' --- языковые файлы | * ''lang/'' --- языковые файлы | ||
| * ''<код языка>/lang.php'' --- локализованные строки, используемые в шаблоне | * ''<код языка>/lang.php'' --- локализованные строки, используемые в шаблоне | ||
| - | * ''<код языка>/settings.php'' --- локализованные строки, используемые на странице настроек «ДокуВики» | + | * ''<код языка>/settings.php'' --- локализованные строки, используемые на странице настроек «Докувики» |
| * ''style.ini'' --- см. [[.:css#style.ini]] | * ''style.ini'' --- см. [[.:css#style.ini]] | ||
| Line 102: | Line 102: | ||
| ===== Автоматизация служебных операций ===== | ===== Автоматизация служебных операций ===== | ||
| - | Почти в самом конце страницы ''[[..:devel:templates:main.php]]'' стандартного шаблона вы можете увидеть вызов функции ''tpl_indexerWebBug()''. Данная функция генерирует HTML-тег ''<img>'', который является результатом запроса к скрипту ''[[..:indexer|lib/exe/indexer.php]]''. Эта необходимая составляющая часть «ДокуВики» выполняет важные служебные функции, обеспечивающие правильную работу системы. Все шаблоны должны включать в себя эту функцию, без неё работа вики может быть нарушена (к примеру, [[..:search|поисковые индексы]] перестанут создаваться) | + | Почти в самом конце страницы ''[[..:devel:templates:main.php]]'' стандартного шаблона вы можете увидеть вызов функции ''tpl_indexerWebBug()''. Данная функция генерирует HTML-тег ''<img>'', который является результатом запроса к скрипту ''[[..:indexer|lib/exe/indexer.php]]''. Эта необходимая составляющая часть «Докувики» выполняет важные служебные функции, обеспечивающие правильную работу системы. Все шаблоны должны включать в себя эту функцию, без неё работа вики может быть нарушена (к примеру, [[..:search|поисковые индексы]] перестанут создаваться) |
| ===== Класс «dokuwiki» ===== | ===== Класс «dokuwiki» ===== | ||
| - | Следует добавить класс ''dokuwiki'' к некоторым «окружающим контент» элементам (либо вокруг всего текста, либо по крайней мере, вокруг ''tpl_content()'') в каждом из шаблонов ''main.php'', ''detail.php'' и ''mediamanager.php''. Это необходимо для того, чтобы быть уверенным в том, что стили «ДокуВики» не пересекаются с другими стилями при интеграции с существующим сайтом, содержащим потенциально конфликтующие CSS. | + | Следует добавить класс ''dokuwiki'' к некоторым «окружающим контент» элементам (либо вокруг всего текста, либо по крайней мере, вокруг ''tpl_content()'') в каждом из шаблонов ''main.php'', ''detail.php'' и ''mediamanager.php''. Это необходимо для того, чтобы быть уверенным в том, что стили «Докувики» не пересекаются с другими стилями при интеграции с существующим сайтом, содержащим потенциально конфликтующие CSS. |
| ===== Включаемые блоки ===== | ===== Включаемые блоки ===== | ||
| - | Включаемые блоки --- простой путь добавления различного статического контента в вашу «ДокуВики» без создания собственного [[..:template|шаблона]]. Вы можете использовать их для добавления стандартного заголовка или логотипа компании на каждую страницу, либо же для размещения информации об отказе от ответственности внизу страницы. | + | Включаемые блоки --- простой путь добавления различного статического контента в вашу «Докувики» без создания собственного [[..:template|шаблона]]. Вы можете использовать их для добавления стандартного заголовка или логотипа компании на каждую страницу, либо же для размещения информации об отказе от ответственности внизу страницы. |
| - | Стандартный шаблон «ДокуВики» ищет файлы со специальными именами в каталоге ''lib/tpl/default/'' и просто включает их в определённые места при отображении страницы. Вы вольны добавить любой HTML-код в эти файлы. Конечно, работать это будет лишь при использовании //стандартного// шаблона. | + | Стандартный шаблон «Докувики» ищет файлы со специальными именами в каталоге ''lib/tpl/default/'' и просто включает их в определённые места при отображении страницы. Вы вольны добавить любой HTML-код в эти файлы. Конечно, работать это будет лишь при использовании //стандартного// шаблона. |
| **Совет** для PHP-разработчиков: вам, вероятно, будет приятно узнать, что в этих файлах можно использовать и PHP-скрипты. | **Совет** для PHP-разработчиков: вам, вероятно, будет приятно узнать, что в этих файлах можно использовать и PHP-скрипты. | ||
| Line 131: | Line 131: | ||
| | ''footer.html'' | В самом низу страницы, перед тегом %%</body>%% | | | ''footer.html'' | В самом низу страницы, перед тегом %%</body>%% | | ||
| - | «ДокуВики» поставляется с образцом файла ''footer.html'', содержащим кнопки лицензии «Creative Commons RDF». | + | «Докувики» поставляется с образцом файла ''footer.html'', содержащим кнопки лицензии «Creative Commons RDF». |
↧
ru:devel:templates - старая версия восстановлена (2013-09-20 12:49)
↧
