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

Материал из Энциклобогии
Версия от 10:28, 20 октября 2021; Всетаинственный (обсуждение | вклад) (Мелкая правка описания чита.)
Перейти к навигации Перейти к поиску

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

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

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

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