Просмотр кода страницы Шаблон:Карточка/doc

{{docpage}}
{{СИШ}}

Это меташаблон для создания [[Википедия:Шаблоны-карточки|шаблонов-карточек]].

== Параметры ==

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

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

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

== Возможности ==

=== Сдвоенные ячейки ===
Если для параметра <code>текст<sub>n</sub></code> значение <code>метка<sub>n</sub></code> не определено, то <code>текст<sub>n</sub></code> автоматически расширяется до 2 ячеек. Для выравнивания по левой стороне можно использовать следующий код:
<pre><nowiki>
|текст2        = {{{параметр|}}}
|стиль_текста2 = text-align:left;
</nowiki></pre>

=== Необязательные ячейки ===
Ряд с меткой, но без текста не будет отображён. Это позволяет легко создавать необязательные параметры в специализированных шаблонах-карточках. Для создания опциональной ячейки используйте параметр следующим образом:
<pre><nowiki>
|метка5 = Население
|текст5 = {{{население|}}}
</nowiki></pre>

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

=== Необязательные заголовки ===
Таким же образом можно организовать необязательные заголовки. Следующий пример будет выводить заголовок «Структура», если параметры <code>содержимое</code> и <code>размещение</code> определены:
<pre><nowiki>
|заголовок5 = {{#if:{{{содержимое|}}}{{{размещение|}}}|Структура}}
|метка6     = Содержимое
|текст6     = {{{содержимое|}}}
|метка7     = Размещение
|текст7     = {{{размещение|}}}
</nowiki></pre>

Если есть заголовокN, то текстN и меткаN игнорируются. Если нет заданного заголовкаN, то показываются текстN и меткаN.
{|
|-
|<pre><nowiki>
|заголовок1 = {{{заголовок1|}}}
|метка1     = {{{метка1|}}}
|текст1     = {{{текст1|}}}
</nowiki></pre>
|}
{|
|-
|<pre><nowiki>
|заголовок1 = заголовок_текст
|метка1     = метка_текст
|текст1     = текст_текст
</nowiki></pre>
|
{| class="wikitable"
|-
! заголовок_текст
|}
|<pre><nowiki>
|заголовок1 = 
|метка1     = метка_текст
|текст1     = текст_текст
</nowiki></pre>
|
{| class="wikitable"
|-
| метка_текст|| текст_текст
|}
|}

=== Оформление параметров ===
Для оформления параметра можно использовать [[Википедия:Функции парсера##if|функцию парсера «#if»]]. Например, следующие строки добавят к параметру <code>текст6</code> подпись кг, если этот параметр определён:

<pre><nowiki>
|метка6 = Масса
|текст6 = {{#if:{{{масса|}}} |{{{масса}}} кг}}
</nowiki></pre>

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

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

== Пустой шаблон ==
<pre>
{{Карточка
|имя              = {{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></pre>

{{скрытый|Заголовок=11-20|Содержание=<pre>
|метка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     = 
</pre>}}
{{скрытый||Заголовок=21-30|Содержание=<pre>
|метка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     = 
</pre>}}
{{скрытый||Заголовок=31-40|Содержание=<pre>
|метка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     = 
</pre>}}
{{скрытый||Заголовок=41-50|Содержание=<pre>
|метка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     = 
</pre>}}
{{скрытый||Заголовок=51-60|Содержание=<pre>
|метка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     = 
</pre>}}

== Примерный шаблон для карточки персоны ==
<pre>{{Карточка
|имя              = {{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|{{{сайт|}}}}}

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

== Конвертация из [[HTML]] ==
При переводе шаблонов, написанных на html (использующих элементы '''div'''), на основу карточки (в основе которой лежит элемент '''table''') следует производить следующую коррекцию:
* увеличить ширину (свойство '''width''') главного фрейма на 10px;
* уменьшить внутренний отступ (свойство '''padding''') там же на 2px;
* задать явно размер и жирность текста (свойство и параметр '''font-weight: normal''' и т. п.).

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

<includeonly>
[[Категория:Шаблоны-карточки|*]]
[[Категория:Шаблоны:Мета-шаблоны]]
</includeonly>