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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

| глубина = 10 м

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

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

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

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

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

Викиданные

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

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

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

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

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

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

| награды = -

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

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

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

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

Параметры

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

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

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

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

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

Изображение

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


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

но не

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

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

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

| ширина = 200px

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

Указание дат

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

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

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

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

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

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

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

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

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

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

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

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

Сайт

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

| длина, м = 5

вместо

| длина = 5 м

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

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

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

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

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

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

Викиданные

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

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

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

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

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

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

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

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

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

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

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

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

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

| метка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) есть другие медиа-свойства Викиданных. Если нет подходящего свойства Викиданных, можно использовать шаблон {{Карточка/изображение}}[21].

Обратите внимание, что при использовании шаблона {{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» из начала музыкальных альбомов или «Улица» из начала улиц. Для этого можно использовать подобный код[22]:

{{#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»[23].

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

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

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

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

Цвета

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

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

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

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

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

или

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

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

В противном случае этого делать не рекомендуется, поскольку пространство между «вверху» и изображением или полем «заголовок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|статья]].

См. также

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

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

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

Примечания

🔥 Top keywords: Заглавная страницаЯндексДуров, Павел ВалерьевичСлужебная:ПоискYouTubeЛунин, Андрей АлексеевичПодносова, Ирина ЛеонидовнаВКонтактеФоллаут (телесериал)WildberriesTelegramРеал Мадрид (футбольный клуб)Богуславская, Зоя БорисовнаДуров, Валерий СемёновичРоссияXVideosСписок умерших в 2024 годуЧикатило, Андрей РомановичFallout (серия игр)Список игроков НХЛ, забросивших 500 и более шайбПопков, Михаил ВикторовичOzon17 апреляИльин, Иван АлександровичMail.ruСёгун (мини-сериал, 2024)Слово пацана. Кровь на асфальтеПутин, Владимир ВладимировичЛига чемпионов УЕФАГагарина, Елена ЮрьевнаБишимбаев, Куандык ВалихановичЛига чемпионов УЕФА 2023/2024Турнир претендентов по шахматам 2024Манчестер СитиMGM-140 ATACMSРоссийский миротворческий контингент в Нагорном КарабахеЗагоризонтный радиолокаторПинапВодительское удостоверение в Российской Федерации