Редактирование: Шаблон:Карточка/doc

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

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

== Возможности ==
=== Сдвоенные ячейки ===
Если для параметра <code>текст<sub>n</sub></code> значение <code>метка<sub>n</sub></code> не определено, то <code>текст<sub>n</sub></code> автоматически расширяется до 2 ячеек.

=== Необязательные ячейки ===
Ряд с меткой, но без текста не будет отображён. Это позволяет легко создавать необязательные параметры в специализированных шаблонах-карточках. Для создания опциональной ячейки используйте параметр следующим образом:
<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"
|-
| метка_текст|| текст_текст
|}
|}

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

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

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

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

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

== Примерный шаблон для карточки персоны ==
<pre>{{Карточка
 |имя               = 
 |класс_тела        = vcard
 |стиль_тела        = 
 |название          = 
 |стиль_названия    = 
 |вверху            = {{#if:{{{имя|}}}|{{{имя}}}|{{PAGENAME}}}}
 |класс_вверху      = fn
 |стиль_вверху      = 
 |вверху2           = {{{оригинал имени|}}}
 |класс_вверху2     = nickname
 |стиль_вверху2     = 
 |изображение       = {{wikidata/p18|{{{фото|}}}}}
 |стиль_изображения = 
 |подпись           = {{{подпись|}}}
 |стиль_подписи     = 
 |стиль_заголовков  = 
 |стиль_меток       = 
 |стиль_текста      = 

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

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

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

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

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

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

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

 |заголовок10 = {{wikidata/p856|{{{сайт|}}}}}
}}</pre>

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

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