Шаблон:Карточка/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 и т. п.).