Энциклобогия:Шаблоны

Материал из Энциклобогии
Версия от 10:34, 21 июля 2015; Mihey yxNet (обсуждение | вклад) (Перенос кратких описаний из шапки категории Категория:Шаблоны с последними обновлениями + краткая справка по вызову шаблонов.)
(разн.) ← Предыдущая | Текущая версия (разн.) | Следующая → (разн.)
Перейти к: навигация, поиск

Механизм шаблонов

Шаблон — это вики-страница, которая является заготовкой оформления (тексты, рамки, изображения, изменяемые тексты) для вставки в другую вики-страницу. Как применять шаблоны в статьях вкратце описано на странице справки по редактированию[1].

Использование шаблонов

Использование шаблона — вставка в редактируемый текст вызова шаблона, в результате чего в месте вызова в отображаемый текст вставляется содержимое другой страницы. Чтобы вызвать шаблон, надо указать его название в двойных фигурных скобках. Например, в режиме правки текущего текста был набран текст, который является вызовом шаблона: {{DateGE}}. В режиме просмотра в месте, где вставлен этот текст, вы видите его отображение, вот оно: 4446й день г. э.. В это место подставилось содержимое страницы Шаблон: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.



Примечания
  1. Интересующиеся тонкостями внутреннего устройства шаблонов и механизмом их работы, могут найти подробные описания в Википедии.
  2. 2,0 2,1 Из-за того, что параметры шаблонов при вызове отделяются друг от друга вертикальными чертами, если в качестве значения параметра вам необходимо использовать вертикальную черту, сделать это напрямую не удастся — вики-движок подумает, что вы просто пытаетесь отделить очередной параметр. Именно в этих случаях и бывает полезен шаблон {{!}}.