Шаблон:Карточка: различия между версиями

Версия 13:35, 5 октября 2020

Документация

[просмотр | править | история | обновить]

Внимание! Это один из самых используемых шаблонов.

Каждое его изменение создаёт дополнительную нагрузку на серверы проекта. Пожалуйста, убедитесь в адекватности и правильности ваших изменений, проверьте их на тестовых страницах.

Это меташаблон для создания шаблонов-карточек.

Параметры

Служебные

имя: Имя шаблона, необходимое для корректной работы служебных инструментов на всех страницах, где используется шаблон. Для простоты можно использовать {{subst:PAGENAME}}.
автозаголовки: Указание «да» приводит к автоматическому скрытию заголовков, после которых, вплоть до следующего заголовка, все поля пусты. Возможно использовать фиктивные заголовки «-» для прерывания области скрытия. Будет работать некорректно, если требуется указать два заголовка подряд — например, при использовании многоуровневых заголовков. В этом случае рекомендуется явно указать «нет» на случай смены значения по умолчанию с «нет» на «да».
from: Указывается элемент Викиданных, из которого берётся информация.

Основные

вверху: Текст, отображаемый вверху таблицы. Обычно это название предмета статьи.
вверху2: Дополнительный текст, отображаемый вверху таблицы. Обычно используется для оригинального названия.
вверху3: Дополнительный текст, отображаемый вверху таблицы.
изображение: Изображение, которое будет отображено под основным заголовком в правой части таблицы (правее заголовков/списков). Параметр изображение допускает стандартный викикод для отображения. Для разных типов параметра можно использовать {{Форматирование изображения}}. Обычно предпочтительнее использовать код {{wikidata|P18|{{{изображение|}}}|caption={{{описание изображения|}}}}}.
подпись: Подпись под изображением. Отображается только в том случае, если задано изображение. При использовании Шаблон:Tlp не заполняется.
изображение2: Дополнительное изображение.
изображение3: Дополнительное изображение.
заголовок_n: Используется для создания заголовков в ряду. Этот и следующие 2 параметра работают при n≥1.
метка_n: Используется для подписи текста
текст_n: Используется для принятия параметров в специализированных шаблонах-карточках.
викиданные_n: Подставляет значение из указанного параметра Викиданных в поле текста, если текст в этой строке определён. Если в поле текста передано значение -, то значение из Викиданных будет скрыто.
внизу
внизу_n: Ячейка во всю ширину таблицы, располагающаяся внизу тела шаблона (то есть под заголовками/метками и текстом).

Стили

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

Возможности

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

Если для параметра текст_n значение метка_n не определено, то текст_n автоматически расширяется до 2 ячеек. Для выравнивания по левой стороне можно использовать следующий код:

|текст2        = {{{параметр|}}}
|стиль_текста2 = text-align:left;

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

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

|метка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}}
|автозаголовки    = да

|стиль_вверху     = background:#cfe3ff;
|стиль_заголовков = background:#dcebff;
|стиль_внизу      = background:#dcebff;

|вверху           = 
|вверху2          = 
|изображение      = 

|заголовок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     =

 ...

|меткаN           = 
|текстN           = 
|викиданныеN      = 

|внизу            = 
}}<noinclude>
{{doc}}
</noinclude>

11-20

|метка11          = 
|текст11          = 
|викиданные11     = 

|метка12          = 
|текст12          = 
|викиданные12     = 

|метка13          = 
|текст13          = 
|викиданные13     = 

|метка14          = 
|текст14          = 
|викиданные14     = 

|метка15          = 
|текст15          = 
|викиданные15     = 

|метка16          = 
|текст16          = 
|викиданные16     = 

|метка17          = 
|текст17          = 
|викиданные17     = 

|метка18          = 
|текст18          = 
|викиданные18     = 

|метка19          = 
|текст19          = 
|викиданные19     = 

|метка20          = 
|текст20          = 
|викиданные20     =

21-30

|метка21          = 
|текст21          = 
|викиданные21     = 
|метка22          = 
|текст22          = 
|викиданные22     = 
|метка23          = 
|текст23          = 
|викиданные23     = 

|метка24          = 
|текст24          = 
|викиданные24     = 

|метка25          = 
|текст25          = 
|викиданные25     = 

|метка26          = 
|текст26          = 
|викиданные26     = 

|метка27          = 
|текст27          = 
|викиданные27     = 

|метка28          = 
|текст28          = 
|викиданные28     = 

|метка29          = 
|текст29          = 
|викиданные29     = 

|метка30          = 
|текст30          = 
|викиданные30     =

31-40

|метка31          = 
|текст31          = 
|викиданные31     = 

|метка32          = 
|текст32          = 
|викиданные32     = 

|метка33          = 
|текст33          = 
|викиданные33     = 

|метка34          = 
|текст34          = 
|викиданные34     = 

|метка35          = 
|текст35          = 
|викиданные35     = 

|метка36          = 
|текст36          = 
|викиданные36     = 

|метка37          = 
|текст37          = 
|викиданные37     = 

|метка38          = 
|текст38          = 
|викиданные38     = 

|метка39          = 
|текст39          = 
|викиданные39     = 

|метка40          = 
|текст40          = 
|викиданные40     =

41-50

|метка41          = 
|текст41          = 
|викиданные41     = 

|метка42          = 
|текст42          = 
|викиданные42     = 

|метка43          = 
|текст43          = 
|викиданные43     = 

|метка44          = 
|текст44          = 
|викиданные44     = 

|метка45          = 
|текст45          = 
|викиданные45     = 

|метка46          = 
|текст46          = 
|викиданные46     = 

|метка47          = 
|текст47          = 
|викиданные47     = 

|метка48          = 
|текст48          = 
|викиданные48     = 

|метка49          = 
|текст49          = 
|викиданные49     = 

|метка50          = 
|текст50          = 
|викиданные50     =

51-60

|метка51          = 
|текст51          = 
|викиданные51     = 

|метка52          = 
|текст52          = 
|викиданные52     = 

|метка53          = 
|текст53          = 
|викиданные53     = 

|метка54          = 
|текст54          = 
|викиданные54     = 

|метка55          = 
|текст55          = 
|викиданные55     = 

|метка56          = 
|текст56          = 
|викиданные56     = 

|метка57          = 
|текст57          = 
|викиданные57     = 

|метка58          = 
|текст58          = 
|викиданные58     = 

|метка59          = 
|текст59          = 
|викиданные59     = 

|метка60          = 
|текст60          = 
|викиданные60     =

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

{{Карточка
|имя              = {{subst:PAGENAME}}
|автозаголовки    = да

|стиль_вверху     = background:#cfe3ff;
|стиль_заголовков = background:#dcebff;
|стиль_внизу      = background:#dcebff;

|вверху           = {{карточка/имя|{{{имя|}}}}}
|вверху2          = {{карточка/оригинал имени|{{{оригинал имени|}}}}}
|изображение      = {{wikidata|p18|{{{фото|}}}|caption={{{описание изображения|}}}|size={{{ширина|}}}}}

|метка1           = Имя при рождении
|текст1           = {{{имя при рождении|}}}
|викиданные1      = p1477

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

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

|метка4           = Дата смерти
|текст4           = {{wikidata/p570|{{{дата смерти|}}}|{{{дата рождения|}}}}}

|метка5           = Место смерти
|текст5           = {{{место смерти|}}}
|викиданные5      = p20

|метка6           = Гражданство
|текст6           = {{{гражданство|}}}
|викиданные6      = p27

|метка7           = Сценические имена / Прозвище
|текст7           = {{{прозвище|}}}
|викиданные7      = p1449

|заголовок8       = {{wikidata|p856|{{{сайт|}}}}}

|внизу            = {{карточка/Викисклад|{{{викисклад|}}}}}
}}

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

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

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

См. также

Википедия:Шаблоны-карточки
{{Универсальная карточка}}
{{Навигационная таблица}} — для создания горизонтальных навигационных таблиц (предпочтительный вертикальных, иногда делаемых на карточке)
{{Фрагмент таблицы}} — для создания кусков, вставляемых в разные карточки
Подстраницы шаблона Карточка
Участник:Jack who built the house/alignTemplateParameters.js