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

< Шаблон:Карточка
Версия от 15:17, 20 января 2015; Mihey yxNet (обсуждение | вклад) (основные параметры и возможности)
(разн.) ← Предыдущая версия | Текущая версия (разн.) | Следующая версия → (разн.)

Параметры

название
предзаголовок
наименование
изображение
подпись
текст1
заголовок2
метка3текст3
метка4текст4
...
метка12текст12
внизу
внизу2

Основные

название
Верхняя строка в шапке карточки. Обычно это название шаблона, соответствующее использующей его категории.
предзаголовок
Промежуточная строка шапки с уменьшенным шрифтом. Для дополнительных структурных сведений.
наименование
Индивидуальный заголовок. Используется, например, для оригинального названия описываемого в конкретной статье объекта.
изображение
Изображение, которое будет отображено под основным заголовком. Параметр изображение допускает стандартный викикод для отображения.
подпись
Подпись под изображением. Отображается только в том случае, если задано изображение.
внизу, внизу2
Ячейка во всю ширину таблицы, располагающаяся внизу тела шаблона (то есть под заголовками/метками и текстом). Для размещения дополнительных данных, отличных по стилю от основных.


Шаблон поддерживает до 12 типовых строк с настраиваемым форматированием. Номера строк задают их взаимный порядок отображения. В каждой из таких строк:

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


Стили

Передача классов в шаблон не предусмотрена (ввиду ненадобности). Внешний вид карточки стандартизован самим шаблоном, но может быть задан стилями:

стиль_тела
Применяется ко всей карточке, может использоваться, например, для указания её ширины.
  • noborder - параметр, при любом ненулевом значении снимающий полное прочерчивание внутренних рамок шаблона.
стиль_названия, стиль_предзаголовка, стиль_наименования
Применяются к ячейкам (строкам) шапки. Позволяет убрать курсивное начертание или измененить размер шрифта: font-style:normal; font-size:medium;
стиль_изображения
Применяется к ячейке, в которой располагается изображение и его описание
стиль_подписи
Применяется к подписи изображения
стиль_внизу, стиль_внизу2
позволяют изменить стиль замыкающих шаблон строк, в частности, указать цвет фона: background: #a3eea3;


стиль_заголовков
С помощью этого стиля можно настроить отображение всех заголовков
стиль_меток
Применяется ко всем меткам
стиль_текста
Применяется ко всему тексту


Возможности

Сдвоенные ячейки

Если для параметра текстn значение меткаn не определено, то текстn автоматически расширяется до 2 ячеек.


Необязательные ячейки

Ряд с меткой, но без текста не будет отображён. Это позволяет легко создавать необязательные параметры в специализированных шаблонах-карточках. Для создания опциональной ячейки используйте параметр следующим образом:

 |метка5 = Описание
 |текст5 = {{{описание|}}}

Таким образом, если параметр описание не будет определён, строка «Описание» не будет отображена.


Необязательные заголовки

Таким же образом можно организовать необязательные заголовки. Следующий пример будет выводить заголовок «Структура», если параметры содержимое и размещение определены:

 |заголовок5 = {{#if:{{{содержимое|}}}{{{размещение|}}}|Структура}}
 |метка6     = Содержимое
 |текст6     = {{{содержимое|}}}
 |метка7     = Размещение
 |текст7     = {{{размещение|}}}

Если есть заголовокn, то текстn и меткаn игнорируются. Если нет заданного заголовкаn, то показываются текстn и (если есть) меткаn.

 |заголовок1 = {{{заголовок1|}}}
 |метка1     = {{{метка1|}}}
 |текст1     = {{{текст1|}}}
 

Например:

 |заголовок1 = заголовок_текст
 |метка1     = метка_текст
 |текст1     = текст_текст
 
заголовок_текст
 |заголовок1 = 
 |метка1     = метка_текст
 |текст1     = текст_текст
 
метка_текст текст_текст

Оформление параметров

Для оформления отображения введённого параметра можно использовать функцию парсера «#if». Например, следующие строки добавят к параметру текст6 подпись кг, если этот параметр определён:

 |метка6 = Доступно героям
 |текст6 = {{#if:{{{доступно героям уровня|}}}|{{{доступно героям уровня}}} уровня}}
 |доступно героям уровня = 12
Доступно героям 12 уровня


Подмену однотипных строк, в том числе ссылок, можно организовать с помощью функции парсера «#switch», например:

 |метка6        = Тип умения
 |текст6        = {{#switch:{{{тип|}}}
  |боевое       = [[:Категория:Умения (боевые)|боевое]]
  |торговое     = [[:Категория:Умения (торговые)|торговое]]
  |транспортное = [[:Категория:Умения (транспортные)|транспортное]]
  }}
 |тип = боевое
Тип умения боевое

Заготовка для копирования