Энциклобогия:Шаблоны — различия между версиями

Материал из Энциклобогии
Перейти к: навигация, поиск
м (Как узнать названия шаблонов и параметров: внесён чит с Предварительным просмотром)
(Отмена правки 132064, сделанной Счастливый Ято (обсуждение))
(Метка: отмена)
 
(не показано 5 промежуточных версий 3 участников)
Строка 8: Строка 8:
  
 
=== Параметры ===
 
=== Параметры ===
Большинство шаблонов обладают параметрами (иногда называемых полями), позволяющими настроить их корректное отображение. У каждого параметра в любом шаблоне есть своё имя. Чтобы при вызове шаблона там же, внутри фигурных скобок задать какому-то параметру значение, надо просто указать это значение после знака равно: <code>имя_параметра = значение_параметра</code>. Чтобы сервер понял, где кончается имя шаблона, а где начинается название параметра, каждую такую запись следует отделять от предыдущей вертикальной чертой<ref name="parameter problem" />, по принципу, отображённому в примере:
+
Большинство шаблонов обладают параметрами (иногда называемых полями), позволяющими настроить их корректное отображение. У каждого параметра в любом шаблоне есть своё имя. Чтобы при вызове шаблона там же, внутри фигурных скобок задать какому-то параметру значение, надо просто указать это значение после знака равно: <code>имя_параметра = значение_параметра</code>. Чтобы сервер понял, где кончается имя шаблона, а где начинается название параметра, каждую такую запись следует отделять от предыдущей вертикальной чертой<ref>Из-за того, что параметры шаблонов при вызове отделяются друг от друга вертикальными чертами, если в качестве значения параметра вам необходимо использовать вертикальную черту, сделать это напрямую не удастся — вики-движок подумает, что вы просто пытаетесь отделить очередной параметр. В таких случаях вместо вертикальной черты можно использовать подстановку <nowiki>{{!}}</nowiki>.</ref>, по принципу, отображённому в примере:
  
 
{| class="standard"
 
{| class="standard"
Строка 43: Строка 43:
 
= Назначение основных шаблонов =
 
= Назначение основных шаблонов =
  
Здесь приводится сокращённый и упорядоченный список с краткими описаниями.
+
Для удобства поиска и хранения однотипные шаблоны объединены в подкатегории (и в головной категории не отображаются). Шаблоны, не имеющие аналогов, хранятся в самой категории [[:Категория:Шаблоны|Шаблоны]]. Здесь приводится их сокращённый и упорядоченный список с кратким описанием области применения<ref>Некоторые шаблоны могут быть не освещены в этой справке в виду их узкой специфики или сомнительной полезности (или просто относительной новизны — краткое описание проверенных в деле шаблонов следует всё же не забывать добавлять сюда).</ref>.
  
 
== Подкатегории ==
 
== Подкатегории ==
  
 
=== [[:Категория:Шаблоны:Карточки]] ===
 
=== [[:Категория:Шаблоны:Карточки]] ===
Тематические шаблоны-карточки предназначены для размещения в краткой форме типовой информации о предмете статьи из числа игровых подкатегорий.
+
Тематические шаблоны-карточки предназначены для размещения в краткой форме типовой информации о предмете статьи из числа игровых подкатегорий (тематических разделов категории [[:Категория:Игровое|Игровое]]). Именно такие карточки как {{tl|Гильдия}}, {{tl|Трофей}}, {{tl|Монстр}} и т. п. обычно размещаются в правом верхнем углу контентных статей.
 +
 
 
=== [[:Категория:Шаблоны:Административные]] ===
 
=== [[:Категория:Шаблоны:Административные]] ===
Административные плашки позволяют в явном виде определять статьи и страницы в соответствующие служебные категории и автоматически их сортировать для последующей доработки.
+
Административные плашки позволяют в явном виде определять статьи и страницы в соответствующие служебные категории и автоматически их сортировать для последующей доработки. С помощью этих шаблонов можно сформировать любой служебный запрос: {{tl|rename}} — на переименование или {{tl|delete}} — на удаление статьи, {{tl|paint}} — на помощь художников или {{tl|help}} — мастеров пера и т. п.
 +
 
 
=== [[:Категория:Шаблоны:Для шаблонов]] ===
 
=== [[:Категория:Шаблоны:Для шаблонов]] ===
Подкатегория для шаблонов, применяющиеся для создания других шаблонов. На страницах статей обычно напрямую не используются за ненадобностью, кроме шаблона {{tl|!}}, позволяющего вводить элементы таблиц или параметры изображений в поля заполняемых шаблонов<ref name="parameter problem" />.
+
Подкатегория для специфических шаблонов, применяющихся для создания других шаблонов. На страницах статей обычно напрямую не используются за ненадобностью.
  
=== [[:Категория:Шаблоны/Документация]] ===
+
=== ''[[:Категория:Шаблоны/Документация]]'' ===
 
Подкатегория для подстраниц документации также не слишком интересна для отдельного изучения — эти подстраницы отображаются непосредственно и на самих страницах шаблонов.
 
Подкатегория для подстраниц документации также не слишком интересна для отдельного изучения — эти подстраницы отображаются непосредственно и на самих страницах шаблонов.
  
Строка 61: Строка 63:
  
 
=== Размещение на странице ===
 
=== Размещение на странице ===
 +
Шаблон {{tl|'}} предназначен для добавления знака ударения ( ́) к символу текста.
 +
 
Шаблон {{tl|-}} служит для отмены обтекания предшествующих ему элементов страницы.
 
Шаблон {{tl|-}} служит для отмены обтекания предшествующих ему элементов страницы.
  
Строка 66: Строка 70:
  
 
Шаблон {{tl|Колонка}} позволяет форматировать текст, обычно список, в несколько колонок.
 
Шаблон {{tl|Колонка}} позволяет форматировать текст, обычно список, в несколько колонок.
 +
 +
Шаблон {{tl|Врезка}} предназначен для визуального выделения из статьи небольших блоков текста.
 +
 +
Шаблон {{tl|Навигационная полоса}} предназначен для создания набора связанных ссылок в конце текста статьи.
  
 
Шаблон {{tl|userbox}} предназначен для коротких вставок текста.
 
Шаблон {{tl|userbox}} предназначен для коротких вставок текста.
 
Шаблон {{tl|Врезка}} предназначен для визуального выделения из статьи небольших блоков текста.
 
  
 
Шаблон {{tl|linkbox}} предназначен для 8 коротких внутренних ссылок на другие статьи.
 
Шаблон {{tl|linkbox}} предназначен для 8 коротких внутренних ссылок на другие статьи.
  
Шаблон {{tl|Навигационная полоса}} предназначен для создания набора связанных ссылок в конце текста статьи.
+
=== Навигационные ===
 +
Шаблон {{tl|Ауры}} предназначен для финишной отделки статей из категории [[:Категория:Ауры|ауры]], выводит список всех аур.
  
=== Навигационные ===
+
Шаблон {{tl|Босс-монстры}} предназначен для финишной отделки статей из категории [[:Категория:Босс-монстры|босс-монстры]], выводит настраиваемый список боссов.
Шаблон {{tl|Аура}} предназначен для финишной отделки статей из категории [[:Категория:Ауры|ауры]], выводит список всех аур.
 
  
 
Шаблон {{tl|Города}} предназначен для финишной отделки статей из категории [[:Категория:Города|города]], выводит список всех городов.
 
Шаблон {{tl|Города}} предназначен для финишной отделки статей из категории [[:Категория:Города|города]], выводит список всех городов.
 +
 +
Шаблон {{tl|Пантеоны}} предназначен для финишной отделки статей из категории [[:Категория:пантеоны|пантеоны]], выводит список всех пантеонов.
  
 
=== Для галерей ===
 
=== Для галерей ===
Строка 90: Строка 98:
 
Шаблон {{tl|Tooltip}} позволяет добавить пояснение в виде всплывающей подсказки к произвольному тексту.
 
Шаблон {{tl|Tooltip}} позволяет добавить пояснение в виде всплывающей подсказки к произвольному тексту.
  
Шаблон {{tl|Hider}} предназначен для того, чтобы скрыть часть текста.
+
Шаблон {{tl|Hider}} предназначен для того, чтобы скрыть часть текста (т. н. «спойлер»). В закрытом состоянии спойлер подвержен наползанию изображений, рекомендуется применять в паре с шаблоном {{tl|-}}.
  
 
=== Боги ===
 
=== Боги ===
Строка 126: Строка 134:
 
----
 
----
 
;Примечания
 
;Примечания
<references>
+
<references/>
<ref name="parameter problem">Из-за того, что параметры шаблонов при вызове отделяются друг от друга вертикальными чертами, если в качестве значения параметра вам необходимо использовать вертикальную черту, сделать это напрямую не удастся — вики-движок подумает, что вы просто пытаетесь отделить очередной параметр. Именно в этих случаях и бывает полезен шаблон {{tl|!}}.</ref>
 
</references>
 

Текущая версия на 11:44, 12 ноября 2018

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

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

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

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