Шаблоны пространства имён
Иногда возникает необходимость в том, чтобы все страницы некоторого пространства имён были основаны на некотором стандартном образце. Например, в пространстве «address» можно было бы иметь заранее подготовленную таблицу, которую необходимо только заполнить данными. Этого можно легко достичь с помощью так называемых «шаблонов пространства имен».
Когда создаётся новая страница, «Докувики» проверяет, существует ли файл шаблона в её пространстве имён и копирует его содержимое в окно редактирования новой страницы.
Файлы шаблона
Могут быть использованы два типа файлов:
_template.txt
— используется в текущем пространстве имён;__template.txt
(два подчеркивания в начале имени) — используется как в текущем, так и во вложенных в текущее пространствах имён.
Шаблон можно создать следующим образом:
- используя вики, сохраните в нужном пространстве имён страницу, которую хотите использовать в качестве шаблона;
- через FTP или WebDAV создайте её копию в той же директории, переименовав в
_template.txt
; - удалите исходную страницу посредством вики, а не FTP.
Синтаксис
Используйте в файле только стандартную разметку.
Автозамены
В шаблонах могут быть использованы некоторые автозаменяемые последовательности:
@ID@ | Полное имя страницы |
---|---|
@NS@ | Пространство имён страницы |
@PAGE@ | Название страницы (без пространства имён и все символы подчеркивания заменены на пробелы) |
@!PAGE@ | То же самое, что и @PAGE@, но первый символ заменяется Заглавной буквой |
@!!PAGE@ | То же самое, что и @PAGE@, но первые символы каждого слова заменяются на Заглавные Буквы |
@!PAGE!@ | То же самое, что и @PAGE@, но все символы заменяются ЗАГЛАВНЫМИ буквами |
@FILE@ | Название страницы (без пространства имён, все символы подчёркивания сохраняются) |
@!FILE@ | То же самое, что и @FILE@, но первый символ заменяется Заглавной буквой |
@!FILE!@ | То же самое, что и @FILE@, но все символы заменяются ЗАГЛАВНЫМИ буквами |
@USER@ | Логин пользователя, создавшего страницу |
@NAME@ | Имя пользователя, создавшего страницу |
@MAIL@ | Почтовый адрес пользователя, создавшего страницу |
@DATE@ | Дата и время начала редактирования страницы (иначе, её создания) |
Также можно использовать символы форматирования strftime, чтобы форматировать время создания страницы так, как вам нравится. Если хотите использовать символ %
в шаблоне, то его необходимо удвоить (%%
).
Редактирование шаблонов
Файлы, начинающиеся со знака подчерка, нельзя редактировать через интерфейс «Докувики» — лишь те, у кого есть доступ к файлам на сервере (обычно это администраторы, использующие FTP или WebDAV), могут редактировать шаблоны. Изменить эту практику можно с помощью плагина TemplatePagename, который задаёт шаблонам базовые имена, доступные для редактирования. Он хорошо сочетается с плагином TemplateByName, существенно расширяющим стандартный список шаблонов.