Инструменты пользователя

Инструменты сайта


wiki:namespace_templates

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

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

1)
Если хотите разрешить всем редактировать шаблон, можете переименовать его в template.txt где-то в районе строки 623 файла inc/common.php. После этого любой пользователь с правами записи в данное пространство имен, может создать страницу template, которая будет использоваться в качестве шаблона.
wiki/namespace_templates.txt · Последние изменения: 2018/10/15 16:40 (внешнее изменение)