Шаблон:Карточка/doc

Шаблон:Карточка · Документация · Сюзюу · Къайда хайырланады

Параметры

Основные

имя: Имя шаблона, необходимое для корректной работы ссылок в строке «Шаблон: Просмотр • Обсуждение • Править» (см. {{Tnavbar}}) на всех страницах, где используется шаблон. Для простоты можно использовать {{subst:PAGENAME}}. Если такие ссылки не нужны, достаточно оставить это поле пустым.
название: Текст, отображаемый над карточкой. Обычно это тема шаблона, краткое описание его содержания.
вверху: Текст, отображаемый вверху таблицы. Альтернативный вариант размещения названия шаблона.
вверху2: Дополнительный текст, отображаемый вверху таблицы. Используется, например, для оригинального названия.
изображение: Изображение, которое будет отображено под основным заголовком в правой части таблицы (правее заголовков/списков). Параметр изображение допускает стандартный викикод для отображения. Для разных типов параметра можно использовать {{Форматирование изображения}}.
подпись: Подпись под изображением. Отображается только в том случае, если задано изображение.
заголовок_n: Используется для создания заголовков в ряду. Этот и следующие 2 параметра работают при 1≤n≤80
метка_n: Используется для подписи текста
текст_n: Используется для принятия параметров в специализированных шаблонах-карточках.
внизу: Ячейка во всю ширину таблицы, располагающаяся внизу тела шаблона (то есть под заголовками/метками и текстом).

Стили

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

Микроформаты

Википедияда бу теманы юсюнден энчи статья барды: Проект:Микроформаты.

класс_тела: Этот параметр передаётся атрибуту class всей карточки.
класс(n): Этот параметр применяется к определённому ряду, если текст в этом ряду определён.
класс_названия: Этот параметр передаётся атрибуту class названия карточки.
класс_вверху: Этот параметр передаётся атрибуту class верхней ячейки.

Например, для реализации микроформата hCard добавьте следующие параметры:

|класс_тела = vcard
|класс1     = fn
|класс2     = org
|класс3     = tel

Возможности

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

Если для параметра текст_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:{{{масса|}}} |{{{масса}}} кг}}

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

 |метка6     = Раса
 |текст6     = {{#switch:{{{раса|}}}
  |Европеоиды   = [[Европеоидная раса|Европеоиды]]
  |Негроиды     = [[Негроидная раса|Негроиды]]
  |Монголоиды   = [[Монголоидная раса|Монголоиды]]
  |{{{раса|}}}

Пустой шаблон

{{Карточка
 |имя               = {{subst:PAGENAME}}
 |стиль_тела        = 
 |название          = 
 |стиль_названия    = 
 |вверху            = 
 |стиль_вверху      = 
 |вверху2           = 
 |стиль_вверху2     = 
 |изображение       = 
 |стиль_изображения = 
 |подпись           = 
 |стиль_подписи     = 
 |стиль_заголовков  = 
 |стиль_меток       = 
 |стиль_текста      = 

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

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

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

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

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

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

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

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

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

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

 ...

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

 |стиль_внизу = 
 |внизу       = 
}}<noinclude>

[[Категория:Википедия:Шаблоны-карточки|{{PAGENAME}}]]
</noinclude>

Примерный шаблон для карточки персоны

{{Карточка
 |имя               = 
 |класс_тела        = vcard
 |стиль_тела        = 
 |название          = 
 |стиль_названия    = 
 |вверху            = {{{Имя}}}
 |класс_вверху      = fn
 |стиль_вверху      = 
 |вверху2           = {{{Оригинал имени|}}}
 |класс_вверху2     = nickname
 |стиль_вверху2     = 
 |изображение       = {{#if:{{{Фото|}}}|[[Файл:{{{Фото}}}|
 {{#if:{{{Ширина|}}}|{{{Ширина}}}|200px}}|
 {{#if:{{{Подпись|}}}|{{{Подпись}}}|Фотография}}]]}}
 |стиль_изображения = 
 |подпись           = {{{Подпись|}}}
 |стиль_подписи     = 
 |стиль_заголовков  = 
 |стиль_меток       = 
 |стиль_текста      = 

 |метка1      = Имя при рождении:
 |текст1      = {{{Имя при рождении|}}}
 |класс1      = nickname

 |метка2      = Дата рождения:
 |текст2      = {{{Дата рождения}}}

 |метка3      = Место рождения:
 |текст3      = {{{Место рождения|}}}

 |метка4      = Дата смерти:
 |текст4      = {{{Дата смерти|}}}

 |метка5      = Место смерти:
 |текст5      = {{{Место смерти|}}}

 |метка6      = Гражданство:
 |текст6      = {{#if:{{{Гражданство|}}}|<span class="country-name">{{{Гражданство}}}</span>}}
 |класс6      = adr

 |метка7      = Сценические имена / Прозвище:
 |текст7      = {{{Прозвище|}}}
 |класс7      = nickname

 |заголовок10 = {{{Сайт|}}}
}}

Конвертация из HTML

При переводе шаблонов, написанных на html (использующих элементы div), на основу карточки (в основе которой лежит элемент table) следует производить следующую коррекцию:

увеличить ширину (свойство width) главного фрейма на 10px;
уменьшить внутренний отступ (свойство padding) там же на 2px;
задать явно размер и жирность текста (свойство и параметр font-weight: normal и т. п.).