Шаблон:Карточка/doc — различия между версиями
м ({{СИШ|100}}) |
WikiSysop (обсуждение | вклад) |
||
| (не показано 9 промежуточных версий 2 участников) | |||
| Строка 1: | Строка 1: | ||
| − | + | <noinclude>{{docpage}}</noinclude> | |
| − | + | == Параметры == | |
| − | + | === Основные === | |
| − | + | ; имя: Имя шаблона, необходимое для корректной работы ссылок в строке «Шаблон: Просмотр • Обсуждение • Править» на всех страницах, где используется шаблон. Для простоты можно использовать <code><nowiki>{{subst:PAGENAME}}</nowiki></code>. Если такие ссылки не нужны, достаточно оставить это поле пустым. | |
| − | ; имя: Имя шаблона, необходимое для корректной работы ссылок | ||
; название: Текст, отображаемый '''над''' карточкой. Обычно это тема шаблона, краткое описание его содержания. | ; название: Текст, отображаемый '''над''' карточкой. Обычно это тема шаблона, краткое описание его содержания. | ||
; вверху: Текст, отображаемый вверху таблицы. Альтернативный вариант размещения названия шаблона. | ; вверху: Текст, отображаемый вверху таблицы. Альтернативный вариант размещения названия шаблона. | ||
; вверху2: Дополнительный текст, отображаемый вверху таблицы. Используется, например, для оригинального названия. | ; вверху2: Дополнительный текст, отображаемый вверху таблицы. Используется, например, для оригинального названия. | ||
| − | ; изображение: Изображение, которое будет отображено под основным заголовком в правой части таблицы (правее заголовков/списков). Параметр ''изображение'' допускает стандартный викикод для отображения | + | ; изображение: Изображение, которое будет отображено под основным заголовком в правой части таблицы (правее заголовков/списков). Параметр ''изображение'' допускает стандартный викикод для отображения. Для разных типов параметра можно использовать {{tl|Форматирование изображения}}. |
; подпись: Подпись под изображением. Отображается только в том случае, если задано изображение. | ; подпись: Подпись под изображением. Отображается только в том случае, если задано изображение. | ||
; заголовок<sub>n</sub>: Используется для создания заголовков в ряду. Этот и следующие 2 параметра работают при 1≤n≤80 | ; заголовок<sub>n</sub>: Используется для создания заголовков в ряду. Этот и следующие 2 параметра работают при 1≤n≤80 | ||
| Строка 14: | Строка 13: | ||
; внизу: Ячейка во всю ширину таблицы, располагающаяся внизу тела шаблона (то есть под заголовками/метками и текстом). | ; внизу: Ячейка во всю ширину таблицы, располагающаяся внизу тела шаблона (то есть под заголовками/метками и текстом). | ||
| − | + | === Стили === | |
; стиль_тела: Применяется ко всей карточке, обычно используется для указания её ширины, например, <code>width:300px;</code> | ; стиль_тела: Применяется ко всей карточке, обычно используется для указания её ширины, например, <code>width:300px;</code> | ||
; стиль_названия: Применяется к названию карточки | ; стиль_названия: Применяется к названию карточки | ||
| Строка 26: | Строка 25: | ||
; стиль_текста: Применяется к тексту | ; стиль_текста: Применяется к тексту | ||
| − | == | + | == Возможности == |
| − | + | === Сдвоенные ячейки === | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
Если для параметра <code>текст<sub>n</sub></code> значение <code>метка<sub>n</sub></code> не определено, то <code>текст<sub>n</sub></code> автоматически расширяется до 2 ячеек. | Если для параметра <code>текст<sub>n</sub></code> значение <code>метка<sub>n</sub></code> не определено, то <code>текст<sub>n</sub></code> автоматически расширяется до 2 ячеек. | ||
| − | === | + | === Необязательные ячейки === |
Ряд с меткой, но без текста не будет отображён. Это позволяет легко создавать необязательные параметры в специализированных шаблонах-карточках. Для создания опциональной ячейки используйте параметр следующим образом: | Ряд с меткой, но без текста не будет отображён. Это позволяет легко создавать необязательные параметры в специализированных шаблонах-карточках. Для создания опциональной ячейки используйте параметр следующим образом: | ||
<pre><nowiki> | <pre><nowiki> | ||
| − | |метка5 = Население | + | |метка5 = Население |
| − | |текст5 | + | |текст5 = {{{население|}}} |
</nowiki></pre> | </nowiki></pre> | ||
Таким образом, если параметр <code>население</code> не будет определён, строка «Население» не будет отображена. | Таким образом, если параметр <code>население</code> не будет определён, строка «Население» не будет отображена. | ||
| − | Для оформления параметра можно использовать [[Википедия:Функции парсера|функцию парсера «#if»]]. Например, следующие строки добавят к параметру <code>текст6</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> | <pre><nowiki> | ||
| − | |метка6 = | + | |метка6 = Масса |
| − | |текст6 | + | |текст6 = {{#if:{{{масса|}}} |{{{масса}}} кг}} |
</nowiki></pre> | </nowiki></pre> | ||
| − | + | А расстановку ссылок на страницы можно организовать с помощью [[wikipedia:Википедия:Функции парсера##switch:|«#switch»]], например: | |
| + | |||
<pre><nowiki> | <pre><nowiki> | ||
| − | | | + | |метка6 = Раса |
| − | | | + | |текст6 = {{#switch:{{{раса|}}} |
| − | | | + | |Европеоиды = [[Европеоидная раса|Европеоиды]] |
| − | | | + | |Негроиды = [[Негроидная раса|Негроиды]] |
| − | + | |Монголоиды = [[Монголоидная раса|Монголоиды]] | |
| + | |{{{раса|}}} | ||
</nowiki></pre> | </nowiki></pre> | ||
| − | + | == Пустой шаблон == | |
<pre>{{Карточка | <pre>{{Карточка | ||
| − | |имя = {{subst:PAGENAME}} | + | |имя = {{subst:PAGENAME}} |
| − | |стиль_тела = | + | |стиль_тела = |
| − | |название = | + | |название = |
| − | |стиль_названия = | + | |стиль_названия = |
| − | |вверху = | + | |вверху = |
| − | |стиль_вверху = | + | |стиль_вверху = |
| − | |вверху2 = | + | |вверху2 = |
| − | |стиль_вверху2 = | + | |стиль_вверху2 = |
| − | |изображение = | + | |изображение = |
| − | |стиль_изображения = | + | |стиль_изображения = |
| − | |подпись = | + | |подпись = |
| − | |стиль_подписи = | + | |стиль_подписи = |
| − | |стиль_заголовков = | + | |стиль_заголовков = |
| − | |стиль_меток = | + | |стиль_меток = |
| − | |стиль_текста = | + | |стиль_текста = |
| − | |заголовок1 = | + | |заголовок1 = |
| − | |метка1 | + | |метка1 = |
| − | |текст1 | + | |текст1 = |
| − | |заголовок2 = | + | |заголовок2 = |
| − | |метка2 | + | |метка2 = |
| − | |текст2 | + | |текст2 = |
| − | |заголовок3 = | + | |заголовок3 = |
| − | |метка3 | + | |метка3 = |
| − | |текст3 | + | |текст3 = |
| − | |заголовок4 = | + | |заголовок4 = |
| − | |метка4 | + | |метка4 = |
| − | |текст4 | + | |текст4 = |
| − | |заголовок5 = | + | |заголовок5 = |
| − | |метка5 | + | |метка5 = |
| − | |текст5 | + | |текст5 = |
| − | |заголовок6 = | + | |заголовок6 = |
| − | |метка6 | + | |метка6 = |
| − | |текст6 | + | |текст6 = |
| − | |заголовок7 = | + | |заголовок7 = |
| − | |метка7 | + | |метка7 = |
| − | |текст7 | + | |текст7 = |
| − | |заголовок8 = | + | |заголовок8 = |
| − | |метка8 | + | |метка8 = |
| − | |текст8 | + | |текст8 = |
| − | |заголовок9 = | + | |заголовок9 = |
| − | |метка9 | + | |метка9 = |
| − | |текст9 | + | |текст9 = |
| − | |заголовок10 = | + | |заголовок10 = |
| − | |метка10 | + | |метка10 = |
| − | |текст10 | + | |текст10 = |
... | ... | ||
| − | | | + | |заголовок120 = |
| − | | | + | |метка120 = |
| − | | | + | |текст120 = |
| − | |стиль_внизу = | + | |стиль_внизу = |
| − | |внизу = | + | |внизу = |
}}<noinclude> | }}<noinclude> | ||
| − | [[Категория: | + | [[Категория:Шаблоны:Карточки|{{PAGENAME}}]] |
</noinclude></pre> | </noinclude></pre> | ||
| − | + | == Примерный шаблон для карточки персоны == | |
<pre>{{Карточка | <pre>{{Карточка | ||
| − | |имя = | + | |имя = |
| − | |класс_тела = vcard | + | |класс_тела = vcard |
| − | |стиль_тела = | + | |стиль_тела = |
| − | |название = | + | |название = |
| − | |стиль_названия = | + | |стиль_названия = |
| − | |вверху = {{{ | + | |вверху = {{#if:{{{имя|}}}|{{{имя}}}|{{PAGENAME}}}} |
| − | |класс_вверху = fn | + | |класс_вверху = fn |
| − | |стиль_вверху = | + | |стиль_вверху = |
| − | |вверху2 = {{{ | + | |вверху2 = {{{оригинал имени|}}} |
| − | |класс_вверху2 = nickname | + | |класс_вверху2 = nickname |
| − | |стиль_вверху2 = | + | |стиль_вверху2 = |
| − | |изображение = {{ | + | |изображение = {{wikidata/p18|{{{фото|}}}}} |
| − | + | |стиль_изображения = | |
| − | + | |подпись = {{{подпись|}}} | |
| − | |стиль_изображения = | + | |стиль_подписи = |
| − | |подпись = {{{ | + | |стиль_заголовков = |
| − | |стиль_подписи = | + | |стиль_меток = |
| − | |стиль_заголовков = | + | |стиль_текста = |
| − | |стиль_меток = | ||
| − | |стиль_текста = | ||
| − | |метка1 | + | |метка1 = Имя при рождении: |
| − | |текст1 | + | |текст1 = {{{имя при рождении|}}} |
| − | |класс1 | + | |класс1 = nickname |
| − | |метка2 | + | |метка2 = Дата рождения: |
| − | |текст2 | + | |текст2 = {{wikidata/p569|{{{дата рождения|}}}|{{{дата смерти|}}}}} |
| − | |метка3 | + | |метка3 = Место рождения: |
| − | |текст3 | + | |текст3 = {{{место рождения|}}} |
| − | |метка4 | + | |метка4 = Дата смерти: |
| − | |текст4 | + | |текст4 = {{wikidata/p570|{{{дата смерти|}}}|{{{дата рождения|}}}}} |
| − | |метка5 | + | |метка5 = Место смерти: |
| − | |текст5 | + | |текст5 = {{{место смерти|}}} |
| − | |метка6 | + | |метка6 = Гражданство: |
| − | |текст6 | + | |текст6 = {{#if:{{{гражданство|}}}|<span class="country-name">{{{гражданство}}}</span>}} |
| − | |класс6 | + | |класс6 = adr |
| − | |метка7 | + | |метка7 = Сценические имена / Прозвище: |
| − | |текст7 | + | |текст7 = {{{прозвище|}}} |
| − | |класс7 | + | |класс7 = nickname |
| − | |заголовок10 = {{{ | + | |заголовок10 = {{wikidata/p856|{{{сайт|}}}}} |
}}</pre> | }}</pre> | ||
| − | == Конвертация из | + | == Конвертация из HTML == |
При переводе шаблонов, написанных на html (использующих элементы '''div'''), на основу карточки (в основе которой лежит элемент '''table''') следует производить следующую коррекцию: | При переводе шаблонов, написанных на html (использующих элементы '''div'''), на основу карточки (в основе которой лежит элемент '''table''') следует производить следующую коррекцию: | ||
* увеличить ширину (свойство '''width''') главного фрейма на 10px; | * увеличить ширину (свойство '''width''') главного фрейма на 10px; | ||
* уменьшить внутренний отступ (свойство '''padding''') там же на 2px; | * уменьшить внутренний отступ (свойство '''padding''') там же на 2px; | ||
| − | * задать явно размер и жирность текста (свойство и параметр '''font-weight: normal''' и т.п.). | + | * задать явно размер и жирность текста (свойство и параметр '''font-weight: normal''' и т. п.). |
| − | |||
| − | |||
| − | |||
| − | |||
| − | [[ | + | <includeonly>[[Категория:Шаблоны:Карточки]]</includeonly> |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | </includeonly> | ||
Текущая версия на 18:56, 18 июля 2015
Содержание
Параметры[править]
Основные[править]
- имя
- Имя шаблона, необходимое для корректной работы ссылок в строке «Шаблон: Просмотр • Обсуждение • Править» на всех страницах, где используется шаблон. Для простоты можно использовать
{{subst:PAGENAME}}. Если такие ссылки не нужны, достаточно оставить это поле пустым. - название
- Текст, отображаемый над карточкой. Обычно это тема шаблона, краткое описание его содержания.
- вверху
- Текст, отображаемый вверху таблицы. Альтернативный вариант размещения названия шаблона.
- вверху2
- Дополнительный текст, отображаемый вверху таблицы. Используется, например, для оригинального названия.
- изображение
- Изображение, которое будет отображено под основным заголовком в правой части таблицы (правее заголовков/списков). Параметр изображение допускает стандартный викикод для отображения. Для разных типов параметра можно использовать {{Форматирование изображения}}.
- подпись
- Подпись под изображением. Отображается только в том случае, если задано изображение.
- заголовокn
- Используется для создания заголовков в ряду. Этот и следующие 2 параметра работают при 1≤n≤80
- меткаn
- Используется для подписи текста
- текстn
- Используется для принятия параметров в специализированных шаблонах-карточках.
- внизу
- Ячейка во всю ширину таблицы, располагающаяся внизу тела шаблона (то есть под заголовками/метками и текстом).
Стили[править]
- стиль_тела
- Применяется ко всей карточке, обычно используется для указания её ширины, например,
width:300px; - стиль_названия
- Применяется к названию карточки
- стиль_изображения
- Применяется к ячейке, в которой располагается изображение и его описание
- стиль_подписи
- Применяется к подписи изображения
- стиль_заголовков
- С помощью этого стиля можно настроить отображение заголовков, в частности, указать цвет фона:
background: #a3eea3; - стиль_вверху
- Применяется к альтернативному заголовку, например, для указания цвета фона или изменения размера шрифта:
font-size:medium; - стиль_вверху2
- Используется для изменения стиля дополнительного текста вверху таблицы, например, чтобы убрать курсивное начертание:
font-style:normal; - стиль_внизу
- CSS стили, которые должны быть применены к верхней (указанной параметром вверху) и нижней (указанной параметром внизу) ячейкам.
- стиль_меток
- Применяется к меткам
- стиль_текста
- Применяется к тексту
Возможности[править]
Сдвоенные ячейки[править]
Если для параметра текст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
|стиль_тела =
|название =
|стиль_названия =
|вверху = {{#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|{{{сайт|}}}}}
}}
Конвертация из HTML[править]
При переводе шаблонов, написанных на html (использующих элементы div), на основу карточки (в основе которой лежит элемент table) следует производить следующую коррекцию:
- увеличить ширину (свойство width) главного фрейма на 10px;
- уменьшить внутренний отступ (свойство padding) там же на 2px;
- задать явно размер и жирность текста (свойство и параметр font-weight: normal и т. п.).