Энциклобогия:Шаблоны
Механизм шаблонов
Шаблон — это вики-страница, которая является заготовкой оформления (тексты, рамки, изображения, изменяемые тексты) для вставки в другую вики-страницу. Как применять шаблоны в статьях вкратце описано на странице справки по редактированию[1].
Использование шаблонов
Использование шаблона — вставка в редактируемый текст вызова шаблона, в результате чего в месте вызова в отображаемый текст вставляется содержимое другой страницы. Чтобы вызвать шаблон, надо указать его название в двойных фигурных скобках. Например, в режиме правки текущего текста был набран текст, который является вызовом шаблона: {{DateGE}}
. В режиме просмотра в месте, где вставлен этот текст, вы видите его отображение, вот оно: 4805й день г. э.. В это место подставилось содержимое страницы Шаблон:DateGE, которая пересчитывает текущую дату в дату по годвилльскому календарю.
Параметры
Большинство шаблонов обладают параметрами (иногда называемых полями), позволяющими настроить их корректное отображение. У каждого параметра в любом шаблоне есть своё имя. Чтобы при вызове шаблона там же, внутри фигурных скобок задать какому-то параметру значение, надо просто указать это значение после знака равно: имя_параметра = значение_параметра
. Чтобы сервер понял, где кончается имя шаблона, а где начинается название параметра, каждую такую запись следует отделять от предыдущей вертикальной чертой[2], по принципу, отображённому в примере:
Вызов без задания параметров | {{Название_шаблона}}
|
Вызов с одним параметром | {{Название_шаблона|имя_параметра_1 = значение_параметра_1}}
|
Вызов с несколькими параметрами | {{Название шаблона|имя_параметра_1 = значение_параметра_1|имя_параметра_2 = значение_параметра_2|имя_параметра_3 = значение_параметра_3}}
|
Допускается также написание в несколько строк | {{Название шаблона |имя_параметра_1 = значение_параметра_1 |имя_параметра_2 = значение_параметра_2 |имя_параметра_3 = значение_параметра_3 }} |
Именем параметра может выступать и число (например, 1, 2, 3, …
), тогда при вызове его имя можно не указывать, а присвоение произойдёт по порядку введения значений. То есть записи вида {{God|1 = Godville}}
и {{God|Godville}}
равнозначны и отобразятся как Godville. Параметров может быть много, но совсем не обязательно их все указывать при вызове и заполнять значениями. Если никакое значение не задано или параметр вообще не упомянут при вызове, шаблон отображается так, будто задано пустое значение. К примеру, вызов шаблона
{{God|Godville|Администратор Годвилля}}
даёт ссылку на профиль бога (имя которого указано в первом поле) и замещает её текстом (указанным во втором поле): Администратор Годвилля. При этом если значение второго параметра не указано
{{God|Godville}}
, то замещение имени альтернативным текстом производиться не будет: Godville. Таким образом второй параметр в этом шаблоне является необязательным. В большинстве оформительских шаблонов предпочтительно оставлять необязательные поля пустыми, чтобы соответсвующие части оформления попросту не отображались, а не заполнять их значениями-пустышками вроде «нет», «не известно», «будет позже», которые приводят отображению того, что должно быть скрыто при отсутствии данных.
Как узнать названия шаблонов и параметров
Найти нужный шаблон можно с помощью сокращённого списка ниже, по полному списку непосредственно в категории Шаблоны и её подкатегориях или воспользовавшись полем поиска справа сверху (не забудьте в настройках поискового запроса поставить галочку для пространства Шаблон).
Более подробно о возможностях и ограничениях каждого шаблона можно узнать из документации непосредственно на его странице (перейдя по ссылке в фигурных скобках из списка ниже), где обычно приводится пример применения и дана заготовка вызова шаблона для копирования.
Назначение основных шаблонов
Здесь приводится сокращённый и упорядоченный список с краткими описаниями.
Подкатегории
Категория:Шаблоны:Карточки
Тематические шаблоны-карточки предназначены для размещения в краткой форме типовой информации о предмете статьи из числа игровых подкатегорий.
Категория:Шаблоны:Административные
Административные плашки позволяют в явном виде определять статьи и страницы в соответствующие служебные категории и автоматически их сортировать для последующей доработки.
Категория:Шаблоны:Для шаблонов
Подкатегория для шаблонов, применяющиеся для создания других шаблонов. На страницах статей обычно напрямую не используются за ненадобностью, кроме шаблона {{!}}, позволяющего вводить элементы таблиц или параметры изображений в поля заполняемых шаблонов[2].
Категория:Шаблоны/Документация
Подкатегория для подстраниц документации также не слишком интересна для отдельного изучения — эти подстраницы отображаются непосредственно и на самих страницах шаблонов.
Шаблоны для форматирования
Размещение на странице
Шаблон {{-}} служит для отмены обтекания предшествующих ему элементов страницы.
Шаблоны {{TOC-Right}} и {{TOC-Left}} выстраивают содержание (оглавление) страницы по правому/левому краю с обтеканием текстом с противоположной стороны.
Шаблон {{Колонка}} позволяет форматировать текст, обычно список, в несколько колонок.
Шаблон {{userbox}} предназначен для коротких вставок текста.
Шаблон {{Врезка}} предназначен для визуального выделения из статьи небольших блоков текста.
Шаблон {{linkbox}} предназначен для 8 коротких внутренних ссылок на другие статьи.
Шаблон {{Навигационная полоса}} предназначен для создания набора связанных ссылок в конце текста статьи.
Навигационные
Шаблон {{Аура}} предназначен для финишной отделки статей из категории ауры, выводит список всех аур.
Шаблон {{Города}} предназначен для финишной отделки статей из категории города, выводит список всех городов.
Для галерей
Шаблон {{Кратное изображение}} более компактная альтернатива классической галереи (сформированной тегом) для отображения тесно связанных одноформатных (обычно парных) изображений.
Шаблон {{Галерея понедельного флешмоба}} предназначен для формирования страниц в категории Понедельный флешмоб в заданном формате.
- Шаблон {{Понедельный флешмоб}} предназначен для оформления разделов таких страниц.
- Шаблон {{Флешмоб}} предназначен для оформления встречной ссылки на любой такой раздел из других статей.
Скрытый текст
Шаблон {{Tooltip}} позволяет добавить пояснение в виде всплывающей подсказки к произвольному тексту.
Шаблон {{Hider}} предназначен для того, чтобы скрыть часть текста.
Боги
Шаблон {{God}} служит для удобной вставки ссылки на основную игровую (НЕ в Энциклобогии!) страницу бога.
Шаблон {{GodLink}} альтернатива для {{God}}, с дополнительными местными ссылками («участник»|«вклад»|«обсуждение») и опционально временем.
Шаблон {{Awards}} служит для отображения информации о наградах («золотых иероглифах») бога.
Время
Шаблон {{DateGE}} преобразует введённую дату в количество дней от/до сотворения Годвилля.
Шаблон {{DaysBetween}} рассчитывает количество дней между двумя заданными датами или заданной и текущей датой.
Цитаты
Шаблон {{Цитата}} предназначен для красивого оформления разного рода цитат.
Шаблон {{Quote}} отображает цитату из дневника аналогично дневниковому оформлению.
Шаблон {{Задание}} отображает текст задания, визуально очень похоже на данные со страницы героя.
Шаблон {{Правила}} для быстрого цитирования общих правил Энциклобогии и вынесения предупреждений.
Отображение специальных символов
Шаблон {{tl}} позволяет указывать ссылку на шаблон так, как это сделано в этом списке описаний.
Шаблон {{tag}} позволяет отображать html-теги.
Метки лицензий
Шаблон {{CC-BY-SA}} ставит на статью чёрную метку лицензии Creative Commons Attribution-Share Alike.
Шаблон {{GFDL}} ставит чёрную метку лицензии GNU Free Documentation License.
- Примечания
- ↑ Интересующиеся тонкостями внутреннего устройства шаблонов и механизмом их работы, могут найти подробные описания в Википедии.
- ↑ 2,0 2,1 Из-за того, что параметры шаблонов при вызове отделяются друг от друга вертикальными чертами, если в качестве значения параметра вам необходимо использовать вертикальную черту, сделать это напрямую не удастся — вики-движок подумает, что вы просто пытаетесь отделить очередной параметр. Именно в этих случаях и бывает полезен шаблон {{!}}.