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

Разделы:

ВП:ШК

Эта страница — эссе о Википедии.Она поясняет некоторые особенности функционирования проекта или отражает мнение части участников о них. Эссе не являются правилами или руководствами. Вы можете обсудить эту страницу или обновить её в соответствии с текущей ситуацией в сообществе.

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

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

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

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

Содержание

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

| глубина = 10 м

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

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

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

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

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

Викиданные

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

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

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

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

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

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

| награды = —

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

Параметры

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

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

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

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

но не

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

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

Ширину изображения в большинстве случаев не имеет смысла заполнять — для фотографий она подгонится под ширину карточки в стационарной версии и немного уже — в мобильной, а для логотипов будет поменьше[4].

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

| оригинал имени = {{lang-la|Nicolaus Copernicus}}

даёт в соответствующем поле лат. Nicolaus Copernicus.

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

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

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

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

| сайт = https://yandex.ru/company

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

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

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

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

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

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

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

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

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

Функционал

Некоторые советы по функционалу:

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

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

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

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

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

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

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

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

| длина, м = 5

вместо

| длина = 5 м

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

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

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

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

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

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

Некоторые советы по технической реализации:

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

| изображение = {{wikidata|P18|{{{изображение|}}}|caption={{{подпись|}}}|size={{{размер|}}}}}

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

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

обычно не требуется переопределять в шаблоне-карточке стандартные размеры изображения из модуля Wikidata, они уже подогнаны для разных свойств Викиданных, см. #Параметры выше;
не рекомендуется добавлять размер изображения в стандартную заготовку для копирования, поскольку в статьях его обычно нет нужды использовать;
помимо свойств изображение (P18) и логотип (P154) есть другие медиа-свойства Викиданных;
если нет подходящего поля Викиданных, можно использовать альтернативные механизмы — шаблон {{Форматирование изображения}} и модуль InfoboxImage;
если необходимо использовать карточку несколько раз в статье, то взятие данных из нужного элемента Викиданных можно настроить при помощи параметра from; при этом его нужно пробросить в шаблон {{Wikidata}}, а в обработчик параметров викиданные он передастся автоматически:

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

при необходимости используйте меташаблоны — подстраницы шаблона Карточка; например, {{Карточка/название}} вверху и {{Карточка/Викисклад}} внизу карточки соответственно;
если нужно перечислить несколько параметров через запятую, но некоторые из них могут отсутствовать, используйте {{comma separated entries}};
заполняйте TemplateData — это позволяет редактировать карточку в визуальном редакторе и упрощает её документирование путём использования шаблонов {{Заготовка шаблона}} и {{Пример шаблона}};
иногда можно использовать обёртки шаблонов-карточек, но практика спорна и, по мнению некоторых участников, напрасно усложняет техподдержку шаблонов;
- тем не менее, полезно делать импортёры карточек для переноса карточек из английского или другого подходящего раздела; в отличие от обычных шаблонов-карточек, импортёры используются с подстановкой;
добавьте в шаблон подходящие подкатегории категории Шаблоны-карточки — как тематические, вроде Шаблоны-карточки:Математика и Шаблоны-карточки:Спорт, так и типовые, вроде Шаблоны-карточки:Организации и Шаблоны-карточки:События.

Оформление

Советы по оформлению:

параметры обычно именуются на русском языке и в формате оригинал имени (не Оригинал имени, оригинал_имени, ОригИм и т. д.);
большинство шаблонов-карточек именуются без слова «карточка», в отличие от других разделов, где обычно добавляется слово «infobox»[7];
размер шрифта в карточках уже уменьшен по сравнению с размером его в статье, поэтому не следует его дополнительно уменьшать, см. соответствующее правило;
- в целом в ручной регулировке шрифтов при правильной разметке обычно нет необходимости — так, в поле вверху автоматически отображается размер 125 %;
тип объекта можно указать над заголовком, в поле вверху0, но в большинстве карточек в этом нет необходимости и это не делается;
нужно проверять работу любого задаваемого вручную оформления в нестандартных скинах, как минимум в MinervaNeue (мобильной версии) и MonoBook (старом основном скине), см. шаблон Тесты шаблона.

Цвета и стили

ВП:ШК-ЦВЕТ

Существует два стандарта цветового оформления.

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

1. Серый. Наиболее распространенный, соответствует {{Персона}}, то есть

| стиль_вверху = background:#eaecf0;| стиль_заголовков = background:#eaecf0;| стиль_внизу = background:#eaecf0;

Выше #eaecf0 — код цвета Base80 из руководства по стилю Викимедиа. Дополнительных цветов для секции «вверху2» и заголовков второго уровня нет, в отличие от второго варианта.

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

2. Синий. Другой вариант основан на стандартном оформлении навигационных таблиц, см. также шаблон-карточку {{Автомобиль}} как пример. Используемая палитра близка к акцентным цветам из руководства по стилю. Этот стандарт рекомендуется использовать при замене шаблонов с цветными заголовками.

| стиль_вверху = background:#cfe3ff;| стиль_заголовков = background:#dcebff;| стиль_внизу = background:#dcebff;

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

| стиль_вверху2 = background:#dcebff;

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

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

| стиль_меток = background:#eaf3ff; padding-left:0.4em; padding-right:0.4em;

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

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

Хотя использование маркированных подпараметров не рекомендуется, при необходимости их можно оформить как в шаблоне {{Государство}}:

| метка2 =  • Подпараметр| стиль_метки2 = font-weight:normal; {{#if: {{{следующий подпараметр1|}}}{{{следующий подпараметр2|}}} | padding-bottom:0; border-bottom:0;}} padding-top:0; border-top:0;| текст2 = {{{подпараметр|}}}| стиль_текста2 = {{#if: {{{следующий подпараметр1|}}}{{{следующий подпараметр2|}}} | padding-bottom:0; border-bottom:0;}} padding-top:0; border-top:0;

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

См. также

Примечания

↑ Терминология чётко не зафиксирована и слова «карточка» и «шаблон-карточка» могут использоваться взаимозаменяемо.
↑ В любую статью можно добавить универсальную карточку, но в большинстве случае это совершенно не нужно делать.
↑ Это продолжение, а начало не имеет отношения к шаблонам-карточкам.
↑ Для этого в шаблоне-карточке соответствующий параметр должен быть, например, подключен к полю логотип (P154) Викиданных путём задания {{wikidata|P154|{{{логотип|}}}}}.
↑ Задание переноса строки в параметрах карточек при помощи тега <br> — способ устаревший, но бывший основным до появления hlist и потому крайне распространённый.
↑ Термин форк также может использоваться для статей, являющихся ответвлениями мнений, но там он используется в другом контексте.
↑ Так, на май 2019 года без слова «карточка» именуются 93 % шаблонов-карточек, см. выдачу PetScan.