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

Иногда возникает необходимость в том, чтобы все страницы некоторого пространства имён были основаны на некотором стандартном образце. Например, в пространстве «address» можно было бы иметь заранее подготовленную таблицу, которую необходимо только заполнить данными. Этого можно легко достичь с помощью так называемых «шаблонов пространства имен».

Когда создаётся новая страница, «[[dokuwiki|Докувики]]» проверяет, существует ли файл шаблона в её пространстве имён и копирует его содержимое в окно редактирования новой страницы.

===== Файлы шаблона =====

Могут быть использованы два типа файлов:

  * ''%%_%%template.txt'' --- используется в текущем пространстве имён;
  * ''%%__%%template.txt'' (два подчеркивания в начале имени) --- используется как в текущем, так и во вложенных в текущее пространствах имён.

Шаблон можно создать следующим образом:

  * используя вики, сохраните в нужном пространстве имён страницу, которую хотите использовать в качестве шаблона;
  * через FTP или WebDAV создайте её копию в той же директории, переименовав в ''_template.txt'';
  * удалите исходную страницу посредством вики, а не FTP.

===== Синтаксис =====

Используйте в файле только [[ru:wiki:syntax|стандартную разметку]].

==== Автозамены ====

В шаблонах могут быть использованы некоторые автозаменяемые последовательности:

^ @ID@     | Полное имя страницы  |
^ @NS@     | Пространство имён страницы   |
^ @PAGE@   | Название страницы (без пространства имён и все символы подчеркивания заменены на пробелы)  |
^ @!PAGE@  | То же самое, что и @PAGE@, но первый символ заменяется Заглавной буквой  |
^ @!!PAGE@ | То же самое, что и @PAGE@, но первые символы каждого слова заменяются на Заглавные Буквы  |
^ @!PAGE!@ | То же самое, что и @PAGE@, но все символы заменяются ЗАГЛАВНЫМИ буквами  |
^ @FILE@   | Название страницы (без пространства имён, все символы подчёркивания сохраняются)  |
^ @!FILE@  | То же самое, что и @FILE@, но первый символ заменяется Заглавной буквой  |
^ @!FILE!@ | То же самое, что и @FILE@, но все символы заменяются ЗАГЛАВНЫМИ буквами  |
^ @USER@   | Логин пользователя, создавшего страницу  |
^ @NAME@   | Имя пользователя, создавшего страницу  |
^ @MAIL@   | Почтовый адрес пользователя, создавшего страницу  |
^ @DATE@   | Дата и время начала редактирования страницы (иначе, её создания)  |

Также можно использовать символы форматирования [[phpfn>strftime]], чтобы форматировать время создания страницы так, как вам нравится. Если хотите использовать символ ''%'' в шаблоне, то его необходимо удвоить (''%%'').

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

Файлы, начинающиеся со знака подчерка, нельзя редактировать через интерфейс «Докувики» --- лишь те, у кого есть доступ к файлам на сервере (обычно это администраторы, использующие FTP или WebDAV), могут редактировать шаблоны. Изменить эту практику можно с помощью плагина [[plugin:templatepagename|TemplatePagename]], который задаёт шаблонам базовые имена, доступные для редактирования. Он хорошо сочетается с плагином [[ru:plugin:templatebyname|TemplateByName]], существенно расширяющим стандартный список шаблонов.