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

Материал из Энциклопедии Гитармага
< Шаблон:Карточка
Версия от 14:26, 30 октября 2009; Admin (обсуждение | вклад) (Новая страница: «<includeonly>{{СИШ|70}}</includeonly><noinclude>{{template navigation}}</noinclude> == Использование == === Параметры === ==== Основн…»)
(разн.) ← Предыдущая | Текущая версия (разн.) | Следующая → (разн.)
Перейти к: навигация, поиск

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

Параметры

Основные

имя
Имя шаблона, необходимое для корректной работы ссылок «просмотр · обсуждение · редактирование» на всех страницах, где используется шаблон. Для простоты можно использовать {{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  = {{{население|}}}

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

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

|метка6 = Mass
|текст6  = {{#if:{{{mass|}}} |{{{mass}}} кг}}

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

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

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

{{Карточка
|имя               = {{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    = 

 ...

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

|стиль_внизу =
|внизу = 
}}<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 и т.п.).