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

Материал из Энциклобогии
Перейти к: навигация, поиск

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

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

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

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

Как узнать названия шаблонов и параметров

Найти нужный шаблон можно с помощью сокращённого списка ниже, по полному списку непосредственно в категории Шаблоны и её подкатегориях или воспользовавшись полем поиска справа сверху (не забудьте в настройках поискового запроса поставить галочку для пространства Шаблон).

Более подробно о возможностях и ограничениях каждого шаблона можно узнать из документации непосредственно на его странице (перейдя по ссылке в фигурных скобках из списка ниже), где обычно приводится пример применения и дана заготовка вызова шаблона для копирования.


Маленький чит. В режиме предварительного просмотра (после нажатия кнопки «Предварительный просмотр») при редактировании текста любой статьи под окном ввода отображается раскрываемый список «Шаблоны, используемые в режиме предпросмотра», который позволяет правым щелчком мыши быстро открыть страницу используемого шаблона и свериться с его документацией на предмет доступных параметров и нюансов их применения.

Назначение основных шаблонов

Для удобства поиска и хранения однотипные шаблоны объединены в подкатегории (и в головной категории не отображаются). Шаблоны, не имеющие аналогов, хранятся в самой категории Шаблоны. Здесь приводится их сокращённый и упорядоченный список с кратким описанием области применения[3].

Подкатегории

Категория:Шаблоны:Карточки

Тематические шаблоны-карточки предназначены для размещения в краткой форме типовой информации о предмете статьи из числа игровых подкатегорий (тематических разделов категории Игровое). Именно такие карточки как {{Гильдия}}, {{Трофей}}, {{Монстр}} и т. п. обычно размещаются в правом верхнем углу контентных статей.

Категория:Шаблоны:Административные

Административные плашки позволяют в явном виде определять статьи и страницы в соответствующие служебные категории и автоматически их сортировать для последующей доработки. С помощью этих шаблонов можно сформировать любой служебный запрос: {{rename}} — на переименование или {{delete}} — на удаление статьи, {{paint}} — на помощь художников или {{help}} — мастеров пера и т. п.

Категория:Шаблоны:Для шаблонов

Подкатегория для специфических шаблонов, применяющихся для создания других шаблонов. На страницах статей обычно напрямую не используются за ненадобностью.

Категория:Шаблоны/Документация

Подкатегория для подстраниц документации также не слишком интересна для отдельного изучения — эти подстраницы отображаются непосредственно и на самих страницах шаблонов.


Шаблоны для форматирования

Размещение на странице

Шаблон {{'}} предназначен для добавления знака ударения ( ́) к символу текста.

Шаблон {{-}} служит для отмены обтекания предшествующих ему элементов страницы.

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