Редактирование: РуСказки:Шаблоны-карточки

<noinclude>{{К улучшению|2023-07-07}}</noinclude>
{{Информационная страница|ВП:ШК}}
<div class="tright" style="text-align: center;">
{{Компания
| название              = Фонд Викимедиа
| оригинальное название = {{Lang-en|Wikimedia Foundation, Inc.}}
| логотип               = Wikimedia Foundation logo - vertical.svg
| тип                   = [[некоммерческая организация]]
| основана              = [[20 июня]] [[2003 год|2003]]
| основатели            = [[Уэйлс, Джимми|Джимми Уэйлс]]
| расположение          = [[Сан-Франциско]], [[США]]
| число сотрудников     = 208 (июль 2014)
| сайт                  = https://wikimediafoundation.org/
}}
{{-}}
<small>Пример карточки, использующей<br>шаблон-карточку {{Tl|Компания}}</small>

{{Персона
| имя                  = Луи Антуан де Сен-Жюст
| оригинал имени       = {{lang-fr|Louis Antoine de Saint-Just}}
| изображение          = Saint-Just-French anon-MBA Lyon 1955-2-IMG 0450.jpg
| описание изображения = Портрет работы [[Прюдон, Пьер Поль|Пьера-Поля Прюдона]], 1793
| род деятельности     = [[Революция|революционер]]
| дата рождения        = 25.08.1767
| место рождения       = [[Десиз]], [[Франция]]
| дата смерти          = 28.07.1794
| место смерти         = [[Париж]], [[Франция]]
| викисклад            = Louis de Saint-Just
}}
{{-}}
<small>Пример карточки, использующей<br>шаблон-карточку {{Tl|Персона}}</small>
</div>
'''Карточки''', или '''инфобоксы''' (от {{Lang-en|infobox}}), — информационные блоки, находящиеся в правом верхнем углу статей рядом с [[Википедия:Преамбула|преамбулой]] и кратко перечисляющие основные параметры описываемого объекта. Карточки создаются при помощи специальных [[Википедия:Шаблоны|шаблонов Википедии]], называемых '''шаблонами-карточками'''<ref>Терминология чётко не зафиксирована и слова «карточка» и «шаблон-карточка» могут использоваться взаимозаменяемо.</ref>.

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

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

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

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

Обратите внимание, что '''''не в каждой статье обязательна карточка'''''. Иногда отсутствие карточки — это нормальное явление, связанное с тем, что карточки перечисляют данные, типичные для схожих статей, а потому, например, в статьях об абстрактных или нетиповых понятиях им нечего описывать<ref>В любую статью можно добавить [[Шаблон:Универсальная карточка|универсальную карточку]], но в большинстве случае это совершенно не нужно делать.</ref>.

== Использование шаблонов-карточек ==
{{См. также|Проект:Инкубатор/Справочники и пособия/Шаблоны-карточки}}
Найти шаблон-карточку для вставки карточки в статью можно в подходящей подкатегории категории [[:Категория:Шаблоны-карточки|Шаблоны-карточки]] или в близкой по тематике статье.

Обратите внимание, что размещение в статье больше одной карточки не рекомендуется. При необходимости разместить дополнительные карточки в разделах необходимо указать {{Para|nocat|1}} для отключения указания категорий, а также {{Para|from|Q''номер элемента''}} для взятия информации Викиданных из нужного элемента<ref>Что-то вроде {{Para|from|-}} для отключения взятия информации с [[Википедия:Викиданные|Викиданных]] не работает.</ref>. При этом параметр {{Para|from}} поддерживается очень небольшим числом карточек.

=== Режим вики-текста ===
Для вставки шаблона в режиме редактирования вики-текста необходимо скопировать в начало статьи, но после блока [[Википедия:Оформление статей#Структура статьи|стандартных шаблонных пометок I]] код заготовки для копирования и заполнить его параметры после знака равенства. Пример заготовки для копирования:
<pre>
{{Что-то там
| название          = 
| оригинал названия = {{lang-XX|}}
| страна            = 
| дата появления    = дд.мм.гггг
}}
</pre>

При этом некоторые параметры могут быть предзаполнены, и их нужно будет или заполнить до конца, или удалить из заготовки. Пример получившегося:
<pre>
{{Что-то там
| название          = Удивительная вещь
| оригинал названия = {{lang-fr|Une chose étonnante}}
| страна            = [[Франция]]
| дата появления    = 
}}
</pre>

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

Редактировать параметры в уже заполненной карточке можно аналогично. Обратите внимание, что параметры шаблонов-карточек жёстко фиксированы — если в нём есть параметры ''длина'', ''ширина'' и ''высота'', но отсутствует параметр ''глубина'', то добавление в код
<pre>
| глубина = 10 м
</pre>
не приведёт к отображению чего-либо на странице. Аналогично, замена ''режиссёр'' на ''режиссёры'', ''создатель'' на ''создательница'' или ''церковь'' на ''Церковь'' при отсутствии соответствующего синонима в шаблоне-карточке только испортит страницу.

=== Визуальный редактор ===
[[Файл:Example of infobox filling in visual editor in ruwiki.png|thumb|300px|Пример заполнения шаблона-карточки в [[Википедия:Визуальный редактор|визуальном редакторе]]]]
Другой способ добавить шаблон-карточку — использовать [[Википедия:Визуальный редактор|визуальный редактор]]. Для этого необходимо выбрать ''Вставить'' — ''Шаблон'' и заполнить параметры в появившемся окошке. К сожалению, такой способ работает не для всех шаблонов-карточек, поскольку требует наличия [[Википедия:TemplateData|TemplateData]] — но вы можете попросить создать её у некоторого шаблона-карточки на [[Википедия:Форум/Технический|техническом форуме]].

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

=== Викиданные ===
[[Файл:Datamodel in Wikidata ru.svg|thumb|500px|Основные термины, связанные с Викиданными: [[d:Wikidata:Glossary#Label|метка]], [[d:Wikidata:Glossary#Statement|утверждение]], [[d:Wikidata:Glossary#Property|свойство]], [[d:Wikidata:Glossary#Values|значение]], на примере [[d:Wikidata:Glossary#Item|элемента]] [[d:Q42|Q42]], к которому привязана статья [[Адамс, Дуглас]] русской Википедии]]
Карточка в статье может брать некоторую информацию из [[Википедия:Викиданные|Викиданных]], если в соответствующем шаблоне-карточке подключено соответствующее свойство Викиданных<ref>В русском разделе у большинства шаблонов-карточек подключено несколько свойств, а в других разделах, в частности в английском, это может быть редкостью.</ref><ref>Существует карточка, которая вообще не имеет параметров и всё берёт из Викиданных, {{Tl|универсальная карточка}}, однако её следует использовать только тогда, когда нет более подходящей карточки, см. подробности в её документации.</ref>.

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

На Викиданных удобно настроить русский язык, для этого нужно выбрать <span class="example" style="font-family: Georgia, serif;">[[d:Special:Preferences|Preferences]] → [[d:Special:Preferences#mw-prefsection-personal|User profile]] → Internationalisation</span>. Также полезно подключить гаджет для отображения кликабельных значков [[Файл:Wikidata-logo.svg|20px]] рядом с полями карточек, значения которых берутся из Викиданных, перейдя по {{Настройки|Gadgets|Отображать метки полей из Викиданных в карточках}}. Рядом есть и другие гаджеты для Викиданных.

Научиться заполнять свойства Викиданных можно в [https://www.wikidata.org/w/index.php?title=Q17339402&tour=wbstatements интерактивном курсе]<ref>Это продолжение, а [https://www.wikidata.org/w/index.php?title=Q16943273&tour=wbitems начало] не имеет отношения к шаблонам-карточкам.</ref>, а другая полезная информация находится на странице [[d:Help:FAQ/ru|часто задаваемых вопросов]].

Чтобы отключить свойство Викиданных, ничего не добавляя взамен, используйте в статье значение <code>-</code>. Например,
<pre>
| награды = -
</pre>
скроет награды в карточке — это может быть нужно, если поле с ними слишком большое (но желательно проверить, что награды перечислены в основном тексте, чтобы не потерять полезную информацию). Скрывать данные нужно довольно редко: если они просто некорректны, лучше исправить или спросить на [[Википедия:Форум/Викиданные|форуме Викиданных]].

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

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

Названия даже стандартных параметров могут широко варьироваться — ''изображение'' или ''фотография'', ''описание изображения'' или ''подпись'', ''дата создания'' или ''создано''<ref>См. некоторые идеи по стандартизации во внутрипроектном соглашении [[Проект:Технические работы/Оформление шаблонов]]</ref>. Капитализация параметров важна — если параметр называется ''место рождения'', то ''Место рождения'' может не работать — в зависимости от указания такого параметра как синонима в шаблоне.

==== Оригинал названия или имени ====
Поля для оригинальных названий и имён заполняются при помощи шаблонов серии {{Tl|Lang-en}}:
{{карточка
| стиль_вверху = background:#cfe3ff;
| вверху       = Николай Коперник
| вверху2      = {{Lang-la|Nicolaus Copernicus}}
}}
<pre>
| имя            = Николай Коперник
| оригинал имени = {{Lang-la|Nicolaus Copernicus}}
</pre>

==== Изображение ====
Поле ''изображение'' заполняется без вики-разметки, а его описание выносится отдельно:
{{карточка
| изображение = {{wikidata|P18|Joe Dassin 1970.jpg|caption=Джо Дассен в 1970 году}}
}}
<pre>
| изображение          = Joe Dassin 1970.jpg
| описание изображения = Джо Дассен в 1970 году
</pre>

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

{{Якорь|Описание изображения на Викиданных}}{{Якорь|Описание изображения в Викиданных}}Обратите внимание, что описание изображения должно находиться в том же месте, что и изображение — если изображение задано на [[Википедия:Викиданные|Викиданных]], то и описание должно быть задано там же. Для этого нужно использовать свойство {{WD|P2096}} как квалификатор — то есть непосредственно под изображением, а не отдельно. Если описание разместить в статье, то после смены изображения на Викиданных оно может перестать соответствовать изображению.

В большинстве случаев не имеет смысла указывать ширину изображения явно — для фотографий она подгонится под ширину карточки в стационарной версии и немного уже — в мобильной, а для логотипов будет поменьше<ref>При условии, что параметр подключен к подходящему полю Викиданных — например, {{WD|P154}} для логотипов.</ref>. Если же возникла необходимость, её можно указать следующим способом:
<pre>
| ширина = 200px
</pre>

При этом указание в {{iw|em (типографика)|em|en|Em (typography)}} не работает, требуется указывать ширину в [[Пиксель|пикселях]]. Можно также опустить px, указав только число, или ввести по-русски: 200пкс.

==== Указание дат ====
Даты рождения и смерти заполняются в формате <code><nowiki>дд.мм.гггг</nowiki></code>:
{{карточка
| стиль_меток = width:10em;
| метка1      = Дата рождения
| текст1      = {{wikidata/p569|22.04.1724|12.02.1804}}
| метка2      = Дата смерти
| текст2      = {{wikidata/p570|12.02.1804|22.04.1724}}
}}
<pre>
| дата рождения = 22.04.1724
| дата смерти   = 12.02.1804
</pre>

При заполнении в таком формате автоматически считается текущий возраст или возраст на момент смерти<ref>При условии, что параметры используют шаблоны {{Tl|wikidata/p569}} и {{Tl|wikidata/p570}}.</ref>.

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

==== Перечисление маркированным списком ====
Некоторые поля заполняют не через запятую, а в столбик, перенося строки — например, главные роли в шаблоне {{Tl|Фильм}}. Для этого можно использовать маркированные списки, но при этом маркеры обычно отображаться не будут<ref>Хотя шаблон может быть настроен так, чтобы маркеры отображались — заданием {{Para|классN|noplainlist}}</ref>.

{{карточка
| стиль_меток = width:10em;
| метка1      = В главных ролях
| текст1      =
* [[Рэдклифф, Дэниел|Дэниел Рэдклифф]]
* [[Уотсон, Эмма|Эмма Уотсон]]
* [[Гринт, Руперт|Руперт Гринт]]
}}
<pre>
| В главных ролях = 
* [[Рэдклифф, Дэниел|Дэниел Рэдклифф]]
* [[Уотсон, Эмма|Эмма Уотсон]]
* [[Гринт, Руперт|Руперт Гринт]]
</pre>

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

==== Медали или награды ====
Поле ''медали'' или ''награды'' можно заполнять при помощи шаблона {{Tl|ряд-л}}, например:
{{карточка
|стиль_меток = width:10em;
|метка1      = Медали
|текст1      =
  {{ряд-л
  | {{Кавалер Большого креста ордена Почётного легиона}}
  | {{Кавалер Большого Креста ордена За заслуги перед ФРГ}}
  | {{Большой крест с лентой Ордена За заслуги перед Итальянской Республикой}}
  }}
  {{ряд-л
  | {{Орден Virtuti Militari 5 степени}}
  | {{Королевский Викторианский орден|GCVO|почётный}}
  | {{Орден Серафимов}}
  }}
}}
<pre>
| медали = 
{{ряд-л
 | {{Кавалер Большого креста ордена Почётного легиона}}
 | {{Кавалер Большого Креста ордена За заслуги перед ФРГ}}
 | {{Большой крест с лентой Ордена За заслуги перед Итальянской Республикой}}
}}
{{ряд-л
 | {{Орден Virtuti Militari 5 степени}}
 | {{Королевский Викторианский орден|GCVO|почётный}}
 | {{Орден Серафимов}}
}}
</pre>

Использовать устаревший синтаксис с <code><nowiki>{{{!}}</nowiki></code>, <code><nowiki>{{!-}}</nowiki></code> и <code><nowiki>{{!}}}</nowiki></code> не рекомендуется<ref>Этот способ подлежит ботозамене согласно итогу на [[Википедия:Форум/Архив/Предложения/2017/12#Переоформление наград с помощью шаблона «Ряд»]].</ref>.

==== Сайт ====
В поле ''сайт'' вводится только гиперссылка, но с префиксом протокола доступа:
{{карточка
| стиль_меток = width:10em;
| метка1      = Сайт
| текст1      = https://wikimediafoundation.org/
| викиданные1 = P856
}}
<pre>
| сайт = https://wikimediafoundation.org/
</pre>

Шаблон {{Tl|URL}} для этого не нужен<ref>При условии, что параметр подключен к полю {{WD|P856}} Викиданных.</ref>.

==== Категория на Викискладе ====
Заполнение поля ''категория на Викискладе'' напрямую в статье нежелательно, лучше сделать это на Викиданных, в поле {{WD|P373}}.

== Редактирование шаблонов-карточек ==
Создание и редактирование шаблонов-карточек требует как технических, так и метапедических навыков и рекомендуется только для опытных участников. В любом случае желательно предварительно проверять свои правки путём [[Википедия:Правка и тестирование шаблонов в песочнице|тестирования на подстранице-песочнице]]. Полезно использовать [[Участник:Jack who built the house/Code Prettifier|скрипт для оформления кода]].

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

=== Создание шаблонов ===
Основное, что нужно знать перед созданием шаблонов-карточек — '''''большинство необходимых шаблонов-карточек уже создано'''''. Если вы не можете найти подходящий, попробуйте спросить на [[Википедия:Форум/Вопросы|форуме вопросов]]. Возможно, подходящий шаблон-карточка уже существует или вместо его создания следует обобщить и дополнить другой шаблон-карточку.

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

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

Запрещено создавать форки — шаблоны, повторяющие уже существующую функциональность, но с некоторыми дополнительными особенностями вроде автонумерации или иного оформления, такие случаи подпадают под [[Википедия:Критерии быстрого удаления#О8|критерий быстрого удаления О8]]<ref>Термин «форк» также может использоваться для статей, являющихся [[Википедия:Ответвление мнений|ответвлениями мнений]], но там он используется в другом контексте.</ref>.

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

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

Не следует использовать технические трюки, усложняющие код и не дающие заметной пользы — благодаря им накапливается [[технический долг]];
* пример такого нежелательного трюка — автовикификация, то есть оборачивание параметра в квадратные скобки в самом шаблоне, а не при его вызове:
<pre>
| текст1 = [[{{{параметр|}}}]]
</pre>
сокращающая заполнение на четыре символа в простых случаях, но принуждающая писать эзотерический код вроде
<pre>
| параметр = Кошечкино (значения){{!}}Кошечкино{{ъъ}}, {{хх}}Собачкино (значения){{!}}Собачкино
</pre>
в более сложных, например при перечислении нескольких значений. Вариант с предварительной проверкой на наличие статьи, вроде
<pre>
| текст1 = {{#ifexist: {{{параметр|}}} | [[{{{параметр}}}]] | {{{параметр|}}} }}
</pre>
тоже плох — поведение шаблона-карточки будет отличаться в зависимости от того, введено в параметр одно значение или же несколько, разделённых запятой, что неинтуитивно.

Не следует задавать значением по умолчанию значение ''неизвестно'': например, появление «автор: неизвестно» в статье о произведении, автор которого не указан в карточке, но известен человечеству, некорректно;
* также не следует делать обязательных параметров, кроме тех, которые действительно необходимы; так, хотя ''оригинал имени'' можно заполнить у любого китайского императора, карточка, у которой этот параметр незаполнен, не должна показывать читателям что-то вроде <code><nowiki>{{{оригинал имени}}}</nowiki></code> — используйте взамен [[:Категория:Отслеживающие категории|отслеживающие категории]].

Нежелательно включение единиц измерения в параметры: использование
<pre>
| длина, м = 5
</pre>
вместо
<pre>
| длина = 5 м
</pre>
только усложняет ситуацию, когда нужно указать сноску или несколько значений для разных контекстов в одном поле.

Регулярно меняющиеся данные вроде номера версии программы, рейтинга сайта или числа просмотров желательно хранить на Викиданных, поскольку там они обновляются также участниками из других разделов и потому свежее; чтобы не знающие этого участники не переопределяли данные локально, вызывая их будущее устаревание, можно отключить параметр в карточке, например
<pre>
| метка1      = Последняя версия
| викиданные1 = P348
</pre>

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

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

=== Детали реализации ===
{{См. также|Шаблон:Карточка|Шаблон:Wikidata}}

==== Викиданные ====
Подключите подходящие свойства [[Википедия:Викиданные|Викиданных]]. В русской Википедии принята широкая интеграция с Викиданными, при которой подключается большинство свойств, которые возможно использовать в карточках<ref>Во французской Википедии и некоторых более мелких разделах также берётся информация с Викиданных, но в очень разных масштабах. В английской Википедии Викиданные практически не используются в карточках, а там, где используется, требуется обязательное указание источника на Викиданных.</ref> — хотя, например, некоторые свойства вроде {{WD|P136}} и {{WD|P172}} обычно не применяются из-за повышенного риска [[Википедия:Недопустимость оригинальных исследований|ориссности]], а некоторые другие свойства не используются по техническим причинам<ref>Например, нет возможности импортировать {{WD|P39}} вместе с квалификаторами в виде, нужном для шаблона {{Tl|Государственная должность}}, и нет корректной поддержки типа ''math''.</ref>.

Некоторую техническую информацию об использовании сведений из Викиданных можно найти в шаблоне {{Tl|Wikidata}}. Для поиска нужного свойства можно ввести в поиске на Викиданных [[d:Special:Search/publisher prefix:p:|''название свойства'' <nowiki>prefix:p:</nowiki>]]. Полезно проверять, используется ли свойство в других шаблонах-карточках, введя в поиске в Википедии [[Служебная:Поиск/incategory:"шаблоны-карточки по алфавиту" insource:"P123" prefix:t:|<nowiki>incategory:"шаблоны-карточки по алфавиту" insource:"</nowiki>''P123''<nowiki>" prefix:t:</nowiki>]].

Помимо полного синтаксиса через шаблон {{Tl|Wikidata}} имеется упрощённый синтаксис — через параметры ''викиданныеN'' шаблона {{Tl|Карточка}}. Его предпочтительнее использовать, потому что тогда код карточек становится более читаемым. Следующие фрагменты эквивалентны<ref>Кроме случая, когда в {{Tl|Карточка}} задан параметр ''from'', см. чуть ниже</ref>:
<pre>
| метка1      = Метка
| текст1      = {{wikidata|P123|{{{параметр|}}}}}
</pre>

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

Полный синтаксис нужен, если требуется указать дополнительные параметры. Например, чтобы утверждения с Викиданных отображались через перенос строки, а не через запятую и союз «и» между двумя последними, можно использовать такой код:
<pre>
| метка1      = Метка
| текст1      = {{wikidata|P123|{{{параметр|}}}|separator=<br>|conjunction=<br>}}
</pre>

При этом часто такие настройки одинаковы для всех включений свойства в карточках, поэтому лучше добавить их в общие настройки на странице [[Модуль:Wikidata/config]]<ref>Запросить добавление можно на странице [[Википедия:Технические запросы]]</ref>.

Если необходимо использовать карточку несколько раз в статье, то взятие данных из нужного элемента Викиданных можно настроить при помощи параметра ''from''; при этом его нужно пробросить в шаблон {{Tl|Wikidata}}, а в параметры ''викиданныеN'' он передастся автоматически:
<pre>
{{Карточка
| from        = {{{from|}}}
| изображение = {{wikidata|P18|{{{изображение|}}}|caption={{{описание изображения|}}}|from={{{from|}}}}}
| метка1      = Метка
| текст1      = {{{параметр|}}}
| викиданные1 = P123
}}
</pre>

Изредка необходимо отображать два свойства Викиданных в одном поле. Это можно использовать следующую конструкцию:
<pre>
| метка1      = Метка
| текст1      = {{#ifeq: {{{параметр|}}} | - | - | {{wikidata|P123|{{{параметр|}}}}} }}
| викиданные1 = P234
</pre>

В первую очередь будет браться информация из свойства P123, и лишь потом — из свойства P234<ref>Использование #ifeq необходимо для того, чтобы работало отключение взятия информации через минус, а иначе внутренний шаблон {{Tl|Wikidata}} оборачивает минус в служебные тэги, а внешний перестаёт воспринимать его как минус.</ref><ref>Возможно, следует внедрить поддержку перечисления свойств через точку с запятой в параметрах ''викиданныеN'' шаблона {{Tl|Карточка}}</ref>.

Можно также добавить служебные тэги, позволяющие быстро импортировать информацию из Википедии на Викиданные через специальный гаджет, см. {{Настройки|Gadgets|Быстрое добавление информации из карточек в Викиданные}}, но без подключения отображения информации с Викиданных в статьях. Для этого следует написать
<pre>
| метка1      = Метка
| текст1      = {{{параметр|}}}
| викиданные1 = {{#if: {{{параметр|}}} | P123 }}
</pre>

===== Изображения =====
Стандартный способ добавлять изображение в шаблон-карточку — при помощи шаблона {{Tl|wikidata}} с указанием подходящего свойства Викиданных:
<pre>
| изображение = {{wikidata|P18|{{{изображение|}}}|caption={{{описание изображения|}}}|size={{{ширина|}}}}}
</pre>
или, в более сложном примере,
<pre>
| изображение  = {{wikidata|P154|{{{логотип|}}}|size={{{ширина логотипа|}}}}}
| изображение2 = {{wikidata|P18[1]|{{{изображение1|}}}|caption={{{описание изображения1|}}}|size={{{ширина1|}}}}}
| изображение3 = {{wikidata|P18[2]|{{{изображение2|}}}|caption={{{описание изображения2|}}}|size={{{ширина2|}}}}}
</pre>

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

Помимо свойств {{WD|P18}} и {{WD|P154}} есть другие [[d:Special:ListProperties/commonsMedia|медиа-свойства Викиданных]]. Если нет подходящего свойства Викиданных, можно использовать шаблон {{Tl|Карточка/изображение}}<ref>Требуется объединение его и модуля [[Модуль:InfoboxImage|InfoboxImage]] в единый механизм — возможно, так с объединением с функцией [[Модуль:Wikidata#formatCommonsMedia|Wikidata.formatCommonsMedia]]. См. также: [[Модуль:Wikidata/media]] как возможное место для объединения</ref>.

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

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

При этом plain-режим не поддерживает квалификаторы, поэтому при их применении нужно использовать {{Para|references|false}}:
<pre>
{{#if: {{wikidata|P123[P234:Q345]|{{{параметр|}}}|references=false}} | если есть | если нет }}
</pre>

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

Категории, добавляемые шаблоном, обычно указывают после кода самой карточки; их следует оборачивать, чтобы они не отображались вне [[Википедия:Пространства имён|основного пространства имён]], а также чтобы была возможность отключить категории вручную параметром ''nocat'' — например, если карточка указана в подразделе статьи. Это можно сделать примерно следующим кодом<:
<pre>
|внизу = {{карточка/Викисклад}}
}}<!--
-->{{#if: {{NAMESPACE}}{{{nocat|}}} || <!--
-->[[Категория:Котики по алфавиту]]<!--
-->{{#if: {{{клубы|}}}{{{футбольная деятельность|}}}{{{тренерские клубы|}}} || [[Категория:Футбол:Статьи с карточками без карьеры]] }}<!--
--> }}<noinclude>{{doc}}</noinclude>
</pre>

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

Отслеживающую категории следует создать и сделать скрытой, чтобы она не отображалась читателям. Включить отображение скрытых категорий можно в меню {{Настройки|Appearance|Показывать скрытые категории}}. Примерный код отслеживающей категории:
<pre>
{{Отслеживающая категория}}
{{tl-generated|Название карточки}}
</pre>

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

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

Иногда полезно изменять ключ сортировки по умолчанию, убирая некоторый стандартный фрагмент из начала названия — например, «The» из начала музыкальных альбомов или «Улица» из начала улиц. Для этого можно использовать подобный код<ref>Возможно, также можно использовать модуль [[Модуль:AdjustSortKey|AdjustSortKey]], но лучше сначала обернуть его в шаблон.</ref>:
<pre>
{{#ifeq: {{str left|{{PAGENAME}}|4}} | The{{sp}} | {{DEFAULTSORT:{{Без начала|{{PAGENAME}}|The}}}} }}
</pre>

==== Меташаблоны ====
При необходимости используйте меташаблоны:
* для добавления различных стандартизированных блоков используйте [[Шаблон:Подстраницы шаблона Карточка|подстраницы шаблона Карточка]]; например, {{Tl|Карточка/название}} вверху и {{Tl|Карточка/Викисклад}} внизу карточки соответственно;
* если требуется отображать метки в разном роде — ''родилась'' или ''родился'' — в зависимости от {{WD|P21}}, используйте {{Tl|Wikidata gender switch}};
* если требуется отображать метки в разном числе — ''параметр'' или ''параметры'' — в зависимости от того, заполнено ли одно значение или несколько, используйте {{Tl|Wikidata number switch}};
* если нужно перечислить несколько параметров через запятую или перенос строки, но некоторые из них могут отсутствовать, используйте {{Tl|comma separated entries}} или {{Tl|br separated entries}} соответственно;

==== Документация ====
Для карточек следует создавать [[Википедия:Документация шаблонов|документацию]], при этом не inline-овую (через {{Tl|doc-inline}}), а вынесенную на отдельную страницу (через {{Tl|doc}}).

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

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

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

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

=== Оформление ===
Параметры обычно именуются на русском языке и в формате ''оригинал имени'' (не ''Оригинал имени'', ''оригинал_имени'', ''ОригИм'' и т. д.);
* большинство шаблонов-карточек именуются без слова «карточка», в отличие от других разделов, где обычно добавляется слово «infobox»<ref>Так, на ноябрь 2019 года без слова «карточка» именуются 93 % шаблонов-карточек, см. [https://petscan.wmflabs.org/?language=ru&project=wikipedia&depth=7&categories=Шаблоны-карточки&ns%5B10%5D=1&doit= выдачу PetScan].</ref>.

Размер шрифта в карточках уже уменьшен по сравнению с размером его в статье, поэтому не следует его дополнительно уменьшать, см. [[Википедия:Оформление статей#Размер текста|соответствующее правило]];
* в целом в ручной регулировке шрифтов при правильной разметке обычно нет необходимости — так, в поле ''вверху'' автоматически отображается размер 125 %.

Тип объекта можно указать над заголовком, в поле ''вверху0'', но в большинстве карточек в этом нет необходимости и это не делается<!-- TODO: выяснить консенсусность -->.

Нужно проверять работу любого задаваемого вручную оформления в нестандартных скинах — обязательно в ''MinervaNeue'', использующемся в мобильной версии<ref>Но скин ''MinervaNeue'' может использоваться и без мобильной версии, поэтому желательно проверить наличие ''ru.m.wikipedia.org'' вместо ''ru.wikipedia.org'' в адресной строке.</ref>, но лучше и в ''MonoBook'', которые ранее был основным скином и всё ещё широко используется зарегистрированными участниками. См. ссылки в шаблоне [[Шаблон:Тесты шаблона|Тесты шаблона]].

==== Цвета ====
{{Якорь|Цвета}}
{{Карточка
| вверху           = Вверху
| вверху2          = {{Lang-en|In the header}}
| заголовок1       = Первый заголовок
| метка2           = Первая метка
| текст2           = первый текст
| метка3           = Вторая метка
| текст3           = второй текст
| метка4           = Третья метка
| текст4           = третий текст
| внизу            = {{карточка/Викисклад|Smth}}
}}
По умолчанию у карточек заголовки и иные блоки имеют голубоватый оттенок, использующий цвета, основанные на стандартном оформлении [[Шаблон:Навигационная таблица|навигационных таблиц]] ('''синяя схема'''). Используемая палитра близка к [https://design.wikimedia.org/style-guide/visual-style_colors.html#accent-colors акцентным цветам] из руководства по стилю от [[Фонд Викимедиа|Фонда Викимедиа]]. Для её использования не нужно заполнять никакие дополнительные параметры.

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

Если в карточке нет поля для изображений и нет поля «заголовок1», или если присутствует поле «вверху3», то для выделения поля «вверху2» можно добавить
<pre>
| класс_вверху2 = infobox-header
</pre>
или
<pre>
| класс_вверху2 = infobox-subheader
</pre>
в случае, если вам нужно два заголовка разного уровня<ref>При использовании заголовков второго уровня желательно явно указать {{Para|автозаголовки|нет}} в шаблоне {{Tl|Карточка}} на случай, если в будущем значение по умолчанию будет изменено с ''нет'' на ''да''.</ref>.

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

{{Карточка
| имя              = Карточка
| цвет             = Base
| вверху           = Вверху
| вверху2          = {{Lang-en|In the header}}
| заголовок1       = Первый заголовок
| метка2           = Первая метка
| текст2           = первый текст
| метка3           = Вторая метка
| текст3           = второй текст
| метка4           = Третья метка
| текст4           = третий текст
| внизу            = {{карточка/Викисклад|Smth}}
}}

'''Серая схема''' — одноцветная схема оформления, использующая цвет <code>#eaecf0</code>, он же [https://design.wikimedia.org/style-guide/visual-style_colors.html#base-colors ''Base80''] из руководства по стилю от [[Фонд Викимедиа|Фонда Викимедиа]]. Это устаревшая схема оформления, сохраняющаяся в ряде шаблонов.

Эта схема задаётся так:
<pre>
| цвет = Base
</pre>
при этом обязательно должен быть заполнен параметр «имя».

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

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

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

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

Использование цветов для меток не рекомендуется. Если они всё же используются, они должны быть бледнее цвета заголовка, а также нужно увеличить паддинги:
<pre>
| стиль_меток = background:{{Цвет|Accent90}}; padding-left:0.4em; padding-right:0.4em;
</pre>

Хотя использование скрываемых блоков в общем случае не рекомендуется, иногда они нужны — например, для обеспечения доступности путём дублирования редких символов картинкой, как в шаблоне {{Tl|Звук}}. В таком случае можно оформить скрываемый блок так, чтобы его заголовок выглядел как подзаголовки в самой карточке. Это делается при помощи шаблона {{Tl|Начало скрытого блока}} c такими параметрами:
<pre>
| текст1        = {{Начало скрытого блока
 | заголовок           = Заголовок
 | выравнивание_текста = center
 | стиль_тела          = padding:0; font-size:100%;
 | стиль_заголовка     = padding:0; background:{{Цвет|Accent80}};
 | рамка               = none
}}
Скрываемое содержимое
{{Конец скрытого блока}}
| стиль_текста1 = padding:0;
</pre>

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

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

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

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

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

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

'''Прочие полезные страницы'''
* {{Tl|Карточка}}
* {{Tl|Wikidata}}
* [[Участник:Jack who built the house/Code Prettifier]]

== Примечания ==
{{Примечания}}

{{Геокарточки}}
{{Антропогенные геокарточки}}
{{Подстраницы шаблона Карточка}}

[[Категория:РуСказки:Справка по шаблонам]]
[[Категория:Шаблоны-карточки|*]]

[[Категория:РуСказки:Эссе:Оформление статей]]