Википедия:Шаблоны-карточки

Фонд Викимедиа
англ. Wikimedia Foundation, Inc.
Тип	некоммерческая организация
Основание	20 июня 2003
Основатели	Джимми Уэйлс
Расположение	Сан-Франциско, США
Число сотрудников	208 (июль 2014)
Сайт	wikimediafoundation.org

Пример карточки, использующей
шаблон-карточку {{Компания}}

Луи Антуан де Сен-Жюст
фр. Louis Antoine de Saint-Just
Портрет работы Пьера-Поля Прюдона, 1793
Дата рождения	25 августа 1767(1767-08-25)
Место рождения	Десиз, Франция
Дата смерти	28 июля 1794(1794-07-28) (26 лет)
Место смерти	Париж, Франция
Род деятельности	революционер
Медиафайлы на Викискладе

Пример карточки, использующей
шаблон-карточку {{Персона}}

Карточки, или инфобоксы (от англ. infobox), — информационные блоки, находящиеся в правом верхнем углу статей рядом с преамбулой и кратко перечисляющие основные параметры описываемого объекта. Карточки создаются при помощи специальных шаблонов Википедии, называемых шаблонами-карточками.

Они вставляются в вики-код статьи копированием заготовки или через визуальный редактор. Шаблоны-карточки могут использовать данные не только из параметров шаблона, но и из Викиданных. Найти шаблон-карточку для вставки карточки в статью можно в подходящей подкатегории категории Шаблоны-карточки или в близкой по тематике статье.

Цель карточек

Цель карточек — приводить ключевые факты из основного текста статьи, а не замещать его. В частности, статья не должна стать неполной после скрытия из неё карточки. Чтобы ключевые факты были легко заметны, карточка должна содержать только небольшое количество полей, а эти поля должны быть заполнены кратко и ёмко.

Тем не менее, в некоторых случаях важную специализированную информацию сложно интегрировать в текст статьи, а в карточке она может быть уместна. Например, таковы промежуточные ранги в шаблоне {{Таксон}} и основные математические характеристики в шаблоне {{Граф}}. Также в карточках без повторения в основном тексте может находиться часто обновляемая информация, хранимая на Викиданных, такая как версия в шаблоне {{Программа}}.

Не следует добавлять в карточки большое количество технических данных и ссылки на разделы статей — для этого есть таблицы с характеристиками и содержание соответственно. Потребность в скрываемых блоках — верный признак того, что карточка перегружена.

Обратите внимание, что не в каждой статье обязательна карточка. Иногда отсутствие карточки — это нормальное явление, связанное с тем, что карточки перечисляют данные, типичные для схожих статей, а потому, например, в статьях об абстрактных или нетиповых понятиях им нечего описывать.

Использование шаблонов-карточек

См. также: Проект:Инкубатор/Справочники и пособия/Шаблоны-карточки

Найти шаблон-карточку для вставки карточки в статью можно в подходящей подкатегории категории Шаблоны-карточки или в близкой по тематике статье.

Обратите внимание, что размещение в статье больше одной карточки не рекомендуется. При необходимости разместить дополнительные карточки в разделах необходимо указать |nocat = 1 для отключения указания категорий, а также |from = Qномер элемента для взятия информации Викиданных из нужного элемента. При этом параметр |from = поддерживается очень небольшим числом карточек.

Режим вики-текста

Для вставки шаблона в режиме редактирования вики-текста необходимо скопировать в начало статьи, но после блока стандартных шаблонных пометок I код заготовки для копирования и заполнить его параметры после знака равенства. Пример заготовки для копирования:

{{Что-то там
| название          = 
| оригинал названия = {{lang-XX|}}
| страна            = 
| дата появления    = дд.мм.гггг
}}

При этом некоторые параметры могут быть предзаполнены, и их нужно будет или заполнить до конца, или удалить из заготовки. Пример получившегося:

{{Что-то там
| название          = Удивительная вещь
| оригинал названия = {{lang-fr|Une chose étonnante}}
| страна            = [[Франция]]
| дата появления    = 
}}

Обычно не нужно удалять пустые параметры — если параметр не задан, то соответствующая строка карточки просто не будет отображаться; напротив, если в будущем понадобится заполнить соответствующее поле, оно уже будет в коде статьи. Также не следует использовать подстановку.

Редактировать параметры в уже заполненной карточке можно аналогично. Обратите внимание, что параметры шаблонов-карточек жёстко фиксированы — если в нём есть параметры длина, ширина и высота, но отсутствует параметр глубина, то добавление в код

| глубина = 10 м

не приведёт к отображению чего-либо на странице. Аналогично, замена режиссёр на режиссёры, создатель на создательница или церковь на Церковь при отсутствии соответствующего синонима в шаблоне-карточке только испортит страницу.

Визуальный редактор

Пример заполнения шаблона-карточки в визуальном редакторе

Другой способ добавить шаблон-карточку — использовать визуальный редактор. Для этого необходимо выбрать Вставить — Шаблон и заполнить параметры в появившемся окошке. К сожалению, такой способ работает не для всех шаблонов-карточек, поскольку требует наличия TemplateData — но вы можете попросить создать её у некоторого шаблона-карточки на техническом форуме.

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

Викиданные

Основные термины, связанные с Викиданными: метка, утверждение, свойство, значение, на примере элемента Q42, к которому привязана статья Адамс, Дуглас русской Википедии

Карточка в статье может брать некоторую информацию из Викиданных, если в соответствующем шаблоне-карточке подключено соответствующее свойство Викиданных.

Если в статье задано локальное значение, то есть значение параметра в вызове шаблона-карточки, то в карточке используется именно оно, переопределяя значение с Викиданных. Чтобы просмотреть заполненные свойства Викиданных, нажмите Элемент Викиданных в блоке ссылок слева от текста статьи. Откроется страница, подобная такой.

На Викиданных удобно настроить русский язык, для этого нужно выбрать Preferences → User profile → Internationalisation. Также полезно подключить гаджет для отображения кликабельных значков рядом с полями карточек, значения которых берутся из Викиданных, перейдя по Настройки → Гаджеты → Отображать метки полей из Викиданных в карточках. Рядом есть и другие гаджеты для Викиданных.

Научиться заполнять свойства Викиданных можно в интерактивном курсе, а другая полезная информация находится на странице часто задаваемых вопросов.

Чтобы отключить свойство Викиданных, ничего не добавляя взамен, используйте в статье значение -. Например,

| награды = -

скроет награды в карточке — это может быть нужно, если поле с ними слишком большое (но желательно проверить, что награды перечислены в основном тексте, чтобы не потерять полезную информацию). Скрывать данные нужно довольно редко: если они просто некорректны, лучше исправить или спросить на форуме Викиданных.

Удаление/возврат информации из карточки

Поскольку карточка может отображать как локально заполненные параметры, так и информацию из Викиданных, во избежание конфликтов, связанных с её очисткой/заполнением, рекомендуется руководствоваться следующими соображениями:

1. Не рекомендуется очищать/заполнять карточки в статьях/списках, обладающими статусом ИС/ХС/ДС. В статусных проектах принято оставлять подобные вопросы на усмотрение основного автора статьи.
2. «Статические» параметры, которые навряд ли будут меняться в будущем (например, место погребения в {{Персона}}), можно оставлять в карточке заполненными, не полагаясь на Викиданные. Это позволит тем, кто держит данную статью в списке наблюдения, более эффективно отслеживать вандализм и бороться с ним. Поэтому:
   1. Если кто-то заменил «статические» сведения на импорт из Викиданных, и статья улучшилась (стала отображаться точнее или полнее, включая категории) — то это изменение полезное.
   2. Если кто-то заменил импорт «статических» сведений из Викиданных внесением их в параметры карточки, и статья не ухудшилась — то это изменение полезное.
3. «Динамические» сведения, которые могут уточняться со временем (например, номер последней версии в {{Программа}}), чаще всего более актуальны в Викиданных, нежели в Википедии; такие параметры рекомендуется оставлять в карточке незаполненными, проводя их указание/актуализацию в ВД. Убирание такого параметра из карточки для автоматической загрузки его из Викиданных, считается полезным действием при условии, что после изменения статья отображается корректно (включая оформление сносок).
4. В остальных случаях изменения в карточках можно отменять как возврат к консенсусному состоянию статьи, дополнительно отсылая оппонента к данному тексту.

Параметры

Некоторые типичные виды параметров заполняются в шаблонах-карточках стандартным способом. При этом устаревшие шаблоны-карточки могут не поддерживать это, в таком случае можно попросить обновить шаблон на странице Википедия:Технические запросы.

Названия даже стандартных параметров могут широко варьироваться — изображение или фотография, описание изображения или подпись, дата создания или создано. Капитализация параметров важна — если параметр называется место рождения, то Место рождения может не работать — в зависимости от указания такого параметра как синонима в шаблоне.

Оригинал названия или имени

Поля для оригинальных названий и имён заполняются при помощи шаблонов серии {{lang-en}}:

Николай Коперник
лат. Nicolaus Copernicus

| имя            = Николай Коперник
| оригинал имени = {{lang-la|Nicolaus Copernicus}}

Изображение

Поле изображение заполняется без вики-разметки, а его описание выносится отдельно:

Джо Дассен в 1970 году

| изображение          = Joe Dassin 1970.jpg
| описание изображения = Джо Дассен в 1970 году

но не

| изображение = [[Файл:Joe Dassin 1970.jpg|Джо Дассен в 1970 году]]

Обратите внимание, что описание изображения должно находиться в том же месте, что и изображение — если изображение задано на Викиданных, то и описание должно быть задано там же. Для этого нужно использовать свойство описание медиа (P2096) как квалификатор — то есть непосредственно под изображением, а не отдельно. Если описание разместить в статье, то после смены изображения на Викиданных оно может перестать соответствовать изображению.

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

| ширина = 200px

При этом указание в em не работает, требуется указывать ширину в пикселях. Можно также опустить px, указав только число, или ввести по-русски: 200пкс.

Указание дат

Даты рождения и смерти заполняются в формате дд.мм.гггг:

Дата рождения	22 апреля 1724(1724-04-22)
Дата смерти	12 февраля 1804(1804-02-12) (79 лет)

| дата рождения = 22.04.1724
| дата смерти   = 12.02.1804

При заполнении в таком формате автоматически считается текущий возраст или возраст на момент смерти.

Некоторые иные даты так же указываются в таком формате, в то же самое время другие указываются как [[дд месяца]] [[гггг]].

Перечисление маркированным списком

Некоторые поля заполняют не через запятую, а в столбик, перенося строки — например, главные роли в шаблоне {{Фильм}}. Для этого можно использовать маркированные списки, но при этом маркеры обычно отображаться не будут.

В главных ролях	Дэниел Рэдклифф Эмма Уотсон Руперт Гринт

| В главных ролях = 
* [[Рэдклифф, Дэниел|Дэниел Рэдклифф]]
* [[Уотсон, Эмма|Эмма Уотсон]]
* [[Гринт, Руперт|Руперт Гринт]]

Использование тега <br> для задания переноса строки — устаревший способ, при котором код менее читаем, поэтому его не рекомендуется использовать.

Медали или награды

Поле медали или награды можно заполнять при помощи шаблона {{ряд-л}}, например:

Медали

| медали = 
{{ряд-л
 | {{Кавалер Большого креста ордена Почётного легиона}}
 | {{Кавалер Большого Креста ордена За заслуги перед ФРГ}}
 | {{Большой крест с лентой Ордена За заслуги перед Итальянской Республикой}}
}}
{{ряд-л
 | {{Орден Virtuti Militari 5 степени}}
 | {{Королевский Викторианский орден|GCVO|почётный}}
 | {{Орден Серафимов}}
}}

Использовать устаревший синтаксис с {{{!}}, {{!-}} и {{!}}} не рекомендуется.

Сайт

В поле сайт вводится только гиперссылка, но с префиксом протокола доступа:

Сайт	wikimediafoundation.org

| сайт = https://wikimediafoundation.org/

Шаблон {{URL}} для этого не нужен.

Категория на Викискладе

Заполнение поля категория на Викискладе напрямую в статье нежелательно, лучше сделать это на Викиданных, в поле категория на Викискладе (P373).

Редактирование шаблонов-карточек

Создание и редактирование шаблонов-карточек требует как технических, так и метапедических навыков и рекомендуется только для опытных участников. В любом случае желательно предварительно проверять свои правки путём тестирования на подстранице-песочнице. Полезно использовать скрипт для оформления кода.

Некоторые примеры шаблонов-карточек — {{Персона}}, {{Художник}}, {{Компания}}, {{Язык}}, {{Единица измерения}} и {{Структура данных}}.

Создание шаблонов

Основное, что нужно знать перед созданием шаблонов-карточек — большинство необходимых шаблонов-карточек уже создано. Если вы не можете найти подходящий, попробуйте спросить на форуме вопросов. Возможно, подходящий шаблон-карточка уже существует или вместо его создания следует обобщить и дополнить другой шаблон-карточку.

Тем не менее, если вы опытный участник Википедии и абсолютно уверены в необходимости создать шаблон-карточку, вы можете сделать это с использованием меташаблона {{Карточка}} — техническая инструкция содержится на соответствующей странице. Не следует использовать таблицы или меташаблоны вида {{Что-то там/строка}}.

Полезно поискать подходящий шаблон-карточку в английской, французской или иной крупной Википедии, перейдя по интервикам, и взять за образец его параметры. Но лучше не копировать его код и оформление — нормы последних в разных разделах могут весьма отличаться.

Запрещено создавать форки — шаблоны, повторяющие уже существующую функциональность, но с некоторыми дополнительными особенностями вроде автонумерации или иного оформления, такие случаи подпадают под критерий быстрого удаления О8.

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

Функциональность

Желательно ограничивать число параметров разумным количеством, не превращая карточки в таблицы технических характеристик и маловажных деталей;

• и напротив, желательно сделать достаточно общие параметры, чтобы можно было использовать шаблон-карточку в широком кругу статей, и при необходимости задать различные заготовки для копирования для разных типов объектов;
• необходимость прятать часть данных в скрываемые блоки — признак того, что карточка перегружена (исключение — обеспечение доступности путём дублирования редких символов картинкой, как в {{Звук}}); кроме того, скрываемые блоки не работают в мобильной версии.

Не следует использовать технические трюки, усложняющие код и не дающие заметной пользы — благодаря им накапливается технический долг;

• пример такого нежелательного трюка — автовикификация, то есть оборачивание параметра в квадратные скобки в самом шаблоне, а не при его вызове:

| текст1 = [[{{{параметр|}}}]]

сокращающая заполнение на четыре символа в простых случаях, но принуждающая писать эзотерический код вроде

| параметр = Кошечкино (значения){{!}}Кошечкино{{ъъ}}, {{хх}}Собачкино (значения){{!}}Собачкино

в более сложных, например при перечислении нескольких значений. Вариант с предварительной проверкой на наличие статьи, вроде

| текст1 = {{#ifexist: {{{параметр|}}} | [[{{{параметр}}}]] | {{{параметр|}}} }}

тоже плох — поведение шаблона-карточки будет отличаться в зависимости от того, введено в параметр одно значение или же несколько, разделённых запятой, что неинтуитивно.

Не следует задавать значением по умолчанию значение неизвестно: например, появление «автор: неизвестно» в статье о произведении, автор которого не указан в карточке, но известен человечеству, некорректно;

• также не следует делать обязательных параметров, кроме тех, которые действительно необходимы; так, хотя оригинал имени можно заполнить у любого китайского императора, карточка, у которой этот параметр незаполнен, не должна показывать читателям что-то вроде {{{оригинал имени}}} — используйте взамен отслеживающие категории.

Нежелательно включение единиц измерения в параметры: использование

| длина, м = 5

вместо

| длина = 5 м

только усложняет ситуацию, когда нужно указать сноску или несколько значений для разных контекстов в одном поле.

Регулярно меняющиеся данные вроде номера версии программы, рейтинга сайта или числа просмотров желательно хранить на Викиданных, поскольку там они обновляются также участниками из других разделов и потому свежее; чтобы не знающие этого участники не переопределяли данные локально, вызывая их будущее устаревание, можно отключить параметр в карточке, например

| метка1      = Последняя версия
| викиданные1 = P348

Не экономьте на длине параметров — если в карточке дифференциального уравнения нужно указывать область определения, называйте поле именно так, а не просто область, даже если других областей в шаблоне-карточке не предвидится.

Желательно согласовать название параметров с другими шаблонами-карточками.

Детали реализации

См. также: Шаблон:Карточка и Шаблон:Wikidata

Викиданные

Подключите подходящие свойства Викиданных. В русской Википедии принята широкая интеграция с Викиданными, при которой подключается большинство свойств, которые возможно использовать в карточках — хотя, например, некоторые свойства вроде жанр (P136) и этническая группа (P172) обычно не применяются из-за повышенного риска ориссности, а некоторые другие свойства не используются по техническим причинам.

Некоторую техническую информацию об использовании сведений из Викиданных можно найти в шаблоне {{Wikidata}}. Для поиска нужного свойства можно ввести в поиске на Викиданных название свойства prefix:p:. Полезно проверять, используется ли свойство в других шаблонах-карточках, введя в поиске в Википедии incategory:"шаблоны-карточки по алфавиту" insource:"P123" prefix:t:.

Помимо полного синтаксиса через шаблон {{Wikidata}} имеется упрощённый синтаксис — через параметры викиданныеN шаблона {{Карточка}}. Его предпочтительнее использовать, потому что тогда код карточек становится более читаемым. Следующие фрагменты эквивалентны:

| метка1      = Метка
| текст1      = {{wikidata|P123|{{{параметр|}}}}}

| метка1      = Метка
| текст1      = {{{параметр|}}}
| викиданные1 = P123

Полный синтаксис нужен, если требуется указать дополнительные параметры. Например, чтобы утверждения с Викиданных отображались через перенос строки, а не через запятую и союз «и» между двумя последними, можно использовать такой код:

| метка1      = Метка
| текст1      = {{wikidata|P123|{{{параметр|}}}|separator=<br>|conjunction=<br>}}

При этом часто такие настройки одинаковы для всех включений свойства в карточках, поэтому лучше добавить их в общие настройки на странице Модуль:Wikidata/config.

Если необходимо использовать карточку несколько раз в статье, то взятие данных из нужного элемента Викиданных можно настроить при помощи параметра from; при этом его нужно пробросить в шаблон {{Wikidata}}, а в параметры викиданныеN он передастся автоматически:

{{Карточка
| from        = {{{from|}}}
| изображение = {{wikidata|P18|{{{изображение|}}}|caption={{{описание изображения|}}}|from={{{from|}}}}}
| метка1      = Метка
| текст1      = {{{параметр|}}}
| викиданные1 = P123
}}

Изредка необходимо отображать два свойства Викиданных в одном поле. Это можно использовать следующую конструкцию:

| метка1      = Метка
| текст1      = {{#ifeq: {{{параметр|}}} | - | - | {{wikidata|P123|{{{параметр|}}}}} }}
| викиданные1 = P234

В первую очередь будет браться информация из свойства P123, и лишь потом — из свойства P234.

Можно также добавить служебные тэги, позволяющие быстро импортировать информацию из Википедии на Викиданные через специальный гаджет, см. Настройки → Гаджеты → Быстрое добавление информации из карточек в Викиданные, но без подключения отображения информации с Викиданных в статьях. Для этого следует написать

| метка1      = Метка
| текст1      = {{{параметр|}}}
| викиданные1 = {{#if: {{{параметр|}}} | P123 }}

Изображения

Стандартный способ добавлять изображение в шаблон-карточку — при помощи шаблона {{wikidata}} с указанием подходящего свойства Викиданных:

| изображение = {{wikidata|P18|{{{изображение|}}}|caption={{{описание изображения|}}}|size={{{ширина|}}}}}

или, в более сложном примере,

| изображение  = {{wikidata|P154|{{{логотип|}}}|size={{{ширина логотипа|}}}}}
| изображение2 = {{wikidata|P18[1]|{{{изображение1|}}}|caption={{{описание изображения1|}}}|size={{{ширина1|}}}}}
| изображение3 = {{wikidata|P18[2]|{{{изображение2|}}}|caption={{{описание изображения2|}}}|size={{{ширина2|}}}}}

Обычно не требуется переопределять в шаблоне-карточке стандартные размеры изображения из модуля Wikidata, они уже подогнаны для разных свойств Викиданных, см. #Параметры выше. Добавлять размер изображения в стандартную заготовку для копирования не рекомендуется, поскольку в статьях его обычно нет нужды использовать, а при добавлении его будут указывать повсеместно.

Помимо свойств изображение (P18) и логотип (P154) есть другие медиа-свойства Викиданных. Если нет подходящего свойства Викиданных, можно использовать шаблон {{Карточка/изображение}}.

Обратите внимание, что при использовании шаблона {{Wikidata}} внутри функции парсера #if сноски ошибочно дублируются. Для исправления нужно использовать |plain = true или шаблон {{If-wikidata}}):

{{#if: {{wikidata|P123|{{{параметр|}}}|plain=true}} | если есть | если нет }}

{{if-wikidata|P123|{{{параметр|}}}|если есть|если нет}}

При этом plain-режим не поддерживает квалификаторы, поэтому при их применении нужно использовать |references = false:

{{#if: {{wikidata|P123[P234:Q345]|{{{параметр|}}}|references=false}} | если есть | если нет }}

Категории

Карточками могут проставляться как чисто статейные категории, вроде Категория:Мединские суры, так и служебные категории. Обычно это либо категории «по алфавиту» (например, Категория:Персоналии по алфавиту), с помощью которых можно следить за добавлениями карточки в статьи, либо отслеживающие категории (типа Категория:Футбол:Статьи с карточками без карьеры), помогающие отслеживать популярные ошибки.

Категории, добавляемые шаблоном, обычно указывают после кода самой карточки; их следует оборачивать, чтобы они не отображались вне основного пространства имён, а также чтобы была возможность отключить категории вручную параметром nocat — например, если карточка указана в подразделе статьи. Это можно сделать примерно следующим кодом<:

|внизу = {{карточка/Викисклад}}
}}<!--
-->{{#if: {{NAMESPACE}}{{{nocat|}}} || <!--
-->[[Категория:Котики по алфавиту]]<!--
-->{{#if: {{{клубы|}}}{{{футбольная деятельность|}}}{{{тренерские клубы|}}} || [[Категория:Футбол:Статьи с карточками без карьеры]] }}<!--
--> }}<noinclude>{{doc}}</noinclude>

Комментарии <!-- --> нужны, чтобы не добавлялись пустые строки: два перевода строки в коде после карточки приведут к появлению пустой строки перед преамбулой в тексте статьи.

Отслеживающую категории следует создать и сделать скрытой, чтобы она не отображалась читателям. Включить отображение скрытых категорий можно в меню Настройки → Внешний вид → Показывать скрытые категории. Примерный код отслеживающей категории:

{{Отслеживающая категория}}
{{tl-generated|Название карточки}}

Один из видов отслеживающих категорий — содержащие страницы, вызывающие неизвестные параметры шаблона. Такую категорию можно установить в шаблоне добавлением {{subst:cfup}} между кодом самой карточки и кодом добавляемых ею категорий, см. модуль Check for unknown parameters.

Для категоризации объектов по году, вроде Категория:Компании, основанные в 1984 году, можно использовать шаблон {{Категория по дате}}.

Иногда полезно изменять ключ сортировки по умолчанию, убирая некоторый стандартный фрагмент из начала названия — например, «The» из начала музыкальных альбомов или «Улица» из начала улиц. Для этого можно использовать подобный код:

{{#ifeq: {{str left|{{PAGENAME}}|4}} | The{{sp}} | {{DEFAULTSORT:{{Без начала|{{PAGENAME}}|The}}}} }}

Меташаблоны

При необходимости используйте меташаблоны:

• для добавления различных стандартизированных блоков используйте подстраницы шаблона Карточка; например, {{Карточка/название}} вверху и {{Карточка/Викисклад}} внизу карточки соответственно;
• если требуется отображать метки в разном роде — родилась или родился — в зависимости от пол или гендер (P21), используйте {{Wikidata gender switch}};
• если требуется отображать метки в разном числе — параметр или параметры — в зависимости от того, заполнено ли одно значение или несколько, используйте {{Wikidata number switch}};
• если нужно перечислить несколько параметров через запятую или перенос строки, но некоторые из них могут отсутствовать, используйте {{comma separated entries}} или {{br separated entries}} соответственно;

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

Для карточек следует создавать документацию, при этом не inline-овую (через {{doc-inline}}), а вынесенную на отдельную страницу (через {{doc}}).

Желательно заполнить TemplateData — это позволяет редактировать карточку в визуальном редакторе и упрощает её документирование путём использования шаблонов {{Заготовка шаблона}} и {{Пример шаблона}}.

Нужно добавить в шаблон подходящие подкатегории категории Шаблоны-карточки — как тематические, вроде Шаблоны-карточки:Математика и Шаблоны-карточки:Спорт, так и типовые, вроде Шаблоны-карточки:Организации и Шаблоны-карточки:События.

Указать отслеживающие категории можно в отдельном разделе «Отслеживающие категории» с использованием шаблона {{Категория с размером}}.

Если шаблон-карточка в значительной степени использует модуль Lua, то следует проставить {{onLua}}. Для точечных использований вроде вызовов строковых функций из модуля String этого делать не стоит, даже с параметром |partly = 1.

Оформление

Параметры обычно именуются на русском языке и в формате оригинал имени (не Оригинал имени, оригинал_имени, ОригИм и т. д.);

• большинство шаблонов-карточек именуются без слова «карточка», в отличие от других разделов, где обычно добавляется слово «infobox».

Размер шрифта в карточках уже уменьшен по сравнению с размером его в статье, поэтому не следует его дополнительно уменьшать, см. соответствующее правило;

• в целом в ручной регулировке шрифтов при правильной разметке обычно нет необходимости — так, в поле вверху автоматически отображается размер 125 %.

Тип объекта можно указать над заголовком, в поле вверху0, но в большинстве карточек в этом нет необходимости и это не делается.

Нужно проверять работу любого задаваемого вручную оформления в нестандартных скинах — обязательно в MinervaNeue, использующемся в мобильной версии, но лучше и в MonoBook, которые ранее был основным скином и всё ещё широко используется зарегистрированными участниками. См. ссылки в шаблоне Тесты шаблона.

Цвета

Вверху
англ. In the header
Первый заголовок
Первая метка	первый текст
Вторая метка	второй текст
Третья метка	третий текст
Медиафайлы на Викискладе

По умолчанию у карточек заголовки и иные блоки имеют голубоватый оттенок, использующий цвета, основанные на стандартном оформлении навигационных таблиц (синяя схема). Используемая палитра близка к акцентным цветам из руководства по стилю от Фонда Викимедиа. Для её использования не нужно заполнять никакие дополнительные параметры.

Как примеры см. шаблоны-карточки {{Компания}} и {{Автомобиль}}.

Если в карточке нет поля для изображений и нет поля «заголовок1», или если присутствует поле «вверху3», то для выделения поля «вверху2» можно добавить

| класс_вверху2 = infobox-header

или

| класс_вверху2 = infobox-subheader

в случае, если вам нужно два заголовка разного уровня.

В противном случае этого делать не рекомендуется, поскольку пространство между «вверху» и изображением или полем «заголовок1» достаточно выделяет поле «вверху2».

Вверху
англ. In the header
Первый заголовок
Первая метка	первый текст
Вторая метка	второй текст
Третья метка	третий текст
Медиафайлы на Викискладе

Серая схема — одноцветная схема оформления, использующая цвет #eaecf0, он же Base80 из руководства по стилю от Фонда Викимедиа. Это устаревшая схема оформления, сохраняющаяся в ряде шаблонов.

Эта схема задаётся так:

| цвет = Base

при этом обязательно должен быть заполнен параметр «имя».

Дополнительных цветов для поля «вверху2» и заголовков второго уровня нет, в отличие от синей схемы.

Как примеры см. шаблон-карточку {{Учёный}}.

Так же могут использоваться другие схемы, одобренные для использования тематическими проектами. Для каждой такой схемы должна быть создана подстраница шаблона {{Цвет}}.

Прочие стили

Если поле «внизу» содержит один из шаблонов категории Шаблоны:Подстраницы шаблона Карточка, ссылку на сайт или примечание, то обычно оно имеет цветной фон; если же там содержится карта, то фон обычно прозрачен.

Использование цветов для меток не рекомендуется. Если они всё же используются, они должны быть бледнее цвета заголовка, а также нужно увеличить паддинги:

| стиль_меток = background:{{Цвет|Accent90}}; padding-left:0.4em; padding-right:0.4em;

Хотя использование скрываемых блоков в общем случае не рекомендуется, иногда они нужны — например, для обеспечения доступности путём дублирования редких символов картинкой, как в шаблоне {{Звук}}. В таком случае можно оформить скрываемый блок так, чтобы его заголовок выглядел как подзаголовки в самой карточке. Это делается при помощи шаблона {{Начало скрытого блока}} c такими параметрами:

| текст1        = {{Начало скрытого блока
 | заголовок           = Заголовок
 | выравнивание_текста = center
 | стиль_тела          = padding:0; font-size:100%;
 | стиль_заголовка     = padding:0; background:{{Цвет|Accent80}};
 | рамка               = none
}}
Скрываемое содержимое
{{Конец скрытого блока}}
| стиль_текста1 = padding:0;

Маркированные подпараметры можно оформить с помощью {{Карточка/блок с маркерами}}. При этом не рекомендуется ими злоупотреблять — заголовки часто предпочтительнее.

Рекомендуется использовать стандартную ширину карточки — 23em (явно указывать не требуется), но при необходимость можно использовать 27em или 19em.

Использование иных стилей не рекомендуется.

Ссылки на статьи в других языковых разделах

При использовании в карточках ссылок на другие языковые разделы следует использовать шаблон {{iw}}. Использование шаблонов {{нп1}}, {{нп2}}, {{нп3}} и {{нп4}} неконсистентно со ссылками, генерируемыми при вызове значений из Викиданных. Также крайне не рекомендуется использовать прямые вики-ссылки вида [[:en:article|статья]].

См. также

Справочные страницы

• Проект:Инкубатор/Справочники и пособия/Шаблоны-карточки
• Проект:Технические работы/Оформление шаблонов
• en:Wikipedia:Manual of Style/Infoboxes
• en:Help:Infobox
• Википедия:Шаблоны
• Википедия:Навигационные шаблоны

Конкретные карточки

• Категория:Шаблоны-карточки
• Проект:Рутинная работа/Все шаблоны-карточки (категория)
• Проект:Рутинная работа/Шаблоны-карточки по числу включений
• Проект:Рутинная работа/Шаблоны для перевода на карточку (категория)
• Проект:Рутинная работа/Шаблоны — возможные кандидаты на объединение

Прочие полезные страницы

• {{Карточка}}
• {{Wikidata}}
• Участник:Jack who built the house/Code Prettifier