Шаблоны пространства имён

Иногда возникает необходимость в том, чтобы все страницы некоторого пространства имён были основаны на некотором стандартном образце. Например, в пространстве «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, чтобы форматировать время создания страницы так, как вам нравится. Если хотите использовать символ % в шаблоне, то его необходимо удвоить (%%).

Редактирование шаблонов

Файл _template.txt нельзя редактировать с помощью интерфейса «Докувики» — лишь те, у кого есть доступ к файлам на сервере (обычно это администраторы, использующие FTP или WebDAV), могут¹⁾ редактировать шаблоны.

¹⁾

Если хотите разрешить всем редактировать шаблон, можете переименовать его в template.txt где-то в районе строки 623 файла inc/common.php. После этого любой пользователь с правами записи в данное пространство имен, может создать страницу template, которая будет использоваться в качестве шаблона.