Руниверсалис:Шаблоны-карточки
Луи Антуан де Сен-Жюст | |
---|---|
фр. Louis Antoine de Saint-Just | |
Дата рождения | 25 августа 1767 |
Место рождения | Десиз, Франция |
Дата смерти | 28 июля 1794 (26 лет) |
Место смерти | Париж, Франция |
Род деятельности | революционер |
Пример карточки, использующей
шаблон-карточку {{Персона}}
Карточки, или инфобоксы (от англ. infobox), — информационные блоки, находящиеся в правом верхнем углу статей рядом с преамбулой и кратко перечисляющие основные параметры описываемого объекта. Карточки создаются при помощи специальных шаблонов, называемых шаблонами-карточками[1].
Они вставляются в вики-код статьи копированием заготовки. Найти шаблон-карточку для вставки карточки в статью можно в подходящей подкатегории категории Шаблоны-карточки или в близкой по тематике статье.
Цель карточек
Цель карточек — приводить ключевые факты из основного текста статьи, а не замещать его. В частности, статья не должна стать неполной после скрытия из неё карточки. Чтобы ключевые факты были легко заметны, карточка должна содержать только небольшое количество полей, а эти поля должны быть заполнены кратко и ёмко.
Не следует добавлять в карточки большое количество технических данных и ссылки на разделы статей — для этого есть таблицы с характеристиками и содержание соответственно. Потребность в скрываемых блоках — верный признак того, что карточка перегружена.
Обратите внимание, что не в каждой статье обязательна карточка. Иногда отсутствие карточки — это нормальное явление, связанное с тем, что карточки перечисляют данные, типичные для схожих статей, а потому, например, в статьях об абстрактных или нетиповых понятиях им нечего описывать.
Использование шаблонов-карточек
Обратите внимание, что размещение в статье больше одной карточки не рекомендуется. При необходимости разместить дополнительные карточки в разделах необходимо указать |nocat=1
для отключения указания категорий. При этом параметр |from=
поддерживается очень небольшим числом карточек.
Для вставки шаблона в режиме редактирования вики-текста необходимо скопировать в начало статьи, но после блока стандартных шаблонных пометок I код заготовки для копирования и заполнить его параметры после знака равенства. Пример заготовки для копирования:
{{Что-то там | название = | оригинал названия = {{lang-XX|}} | страна = | дата появления = дд.мм.гггг }}
При этом некоторые параметры могут быть предзаполнены, и их нужно будет или заполнить до конца, или удалить из заготовки. Пример получившегося:
{{Что-то там | название = Удивительная вещь | оригинал названия = {{lang-fr|Une chose étonnante}} | страна = [[Франция]] | дата появления = }}
Обычно не нужно удалять пустые параметры — если параметр не задан, то соответствующая строка карточки просто не будет отображаться; напротив, если в будущем понадобится заполнить соответствующее поле, оно уже будет в коде статьи. Также не следует использовать подстановку.
Редактировать параметры в уже заполненной карточке можно аналогично. Обратите внимание, что параметры шаблонов-карточек жёстко фиксированы — если в нём есть параметры длина, ширина и высота, но отсутствует параметр глубина, то добавление в код
| глубина = 10 м
не приведёт к отображению чего-либо на странице. Аналогично, замена режиссёр на режиссёры, создатель на создательница или церковь на Церковь при отсутствии соответствующего синонима в шаблоне-карточке только испортит страницу.
Параметры
Некоторые типичные виды параметров заполняются в шаблонах-карточках стандартным способом. При этом устаревшие шаблоны-карточки могут не поддерживать это.
Названия даже стандартных параметров могут широко варьироваться — изображение или фотография, описание изображения или подпись, дата создания или создано. Капитализация параметров важна — если параметр называется место рождения, то Место рождения может не работать — в зависимости от указания такого параметра как синонима в шаблоне.
Оригинал названия или имени
Поля для оригинальных названий и имён заполняются при помощи шаблонов серии {{lang-en}}:
Николай Коперник | |
---|---|
лат. Nicolaus Copernicus |
| имя = Николай Коперник | оригинал имени = {{lang-la|Nicolaus Copernicus}}
Изображение
Поле изображение заполняется без вики-разметки, а его описание выносится отдельно:
| изображение = Joe Dassin 1970.jpg | описание изображения = Джо Дассен в 1970 году
но не
| изображение = [[Файл:Joe Dassin 1970.jpg|Джо Дассен в 1970 году]]
В большинстве случаев не имеет смысла указывать ширину изображения явно — для фотографий она подгонится под ширину карточки в стационарной версии и немного уже — в мобильной, а для логотипов будет поменьше. Если же возникла необходимость, её можно указать следующим способом:
| ширина = 200px
При этом указание в em не работает, требуется указывать ширину в пикселях.
Указание дат
Даты рождения и смерти заполняются в формате дд.мм.гггг
:
| дата рождения = 22.04.1724 | дата смерти = 12.02.1804
При заполнении в таком формате автоматически считается текущий возраст или возраст на момент смерти.
Перечисление маркированным списком
Некоторые поля заполняют не через запятую, а в столбик, перенося строки — например, главные роли в шаблоне {{Фильм}}. Для этого можно использовать маркированные списки, но при этом маркеры обычно отображаться не будут[2].
В главных ролях |
---|
| В главных ролях = * [[Рэдклифф, Дэниел|Дэниел Рэдклифф]] * [[Уотсон, Эмма|Эмма Уотсон]] * [[Гринт, Руперт|Руперт Гринт]]
Использование тега <br>
для задания переноса строки — устаревший способ, при котором код менее читаем, поэтому его не рекомендуется использовать.
Медали или награды
Поле медали или награды можно заполнять при помощи шаблона {{ряд-л}}, например:
Медали |
|
---|
| медали = {{ряд-л | {{Кавалер Большого креста ордена Почётного легиона}} | {{Кавалер Большого Креста ордена За заслуги перед ФРГ}} | {{Большой крест с лентой Ордена За заслуги перед Итальянской Республикой}} }} {{ряд-л | {{Орден Virtuti Militari 5 степени}} | {{Королевский Викторианский орден|GCVO|почётный}} | {{Орден Серафимов}} }}
Использовать устаревший синтаксис с {{{!}}
, {{!-}}
и {{!}}}
не рекомендуется.
Сайт
В поле сайт вводится только гиперссылка, но с префиксом протокола доступа:
Сайт | https://wikimediafoundation.org/ |
---|
| сайт = https://wikimediafoundation.org/
Шаблон {{URL}} для этого не нужен.
Редактирование шаблонов-карточек
Создание и редактирование шаблонов-карточек требует как технических, так и метапедических навыков и рекомендуется только для опытных участников. В любом случае желательно предварительно проверять свои правки путём тестирования на подстранице-песочнице.
Некоторые примеры шаблонов-карточек — {{Персона}}[3], {{Художник}}, {{Компания}}, {{Язык}}, {{Единица измерения}} и {{Структура данных}}.
Создание шаблонов
Основное, что нужно знать перед созданием шаблонов-карточек — большинство необходимых шаблонов-карточек уже создано. Возможно, подходящий шаблон-карточка уже существует или вместо его создания следует обобщить и дополнить другой шаблон-карточку.
Тем не менее, если вы опытный участник и абсолютно уверены в необходимости создать шаблон-карточку, вы можете сделать это с использованием меташаблона {{Карточка}} — техническая инструкция содержится на соответствующей странице. Не следует использовать таблицы или меташаблоны вида {{Что-то там/строка}}.
Полезно поискать подходящий шаблон-карточку в английской, французской или иной крупной Википедии и взять за образец его параметры. Но лучше не копировать его код и оформление — нормы последних в разных разделах могут весьма отличаться.
Запрещено создавать форки — шаблоны, повторяющие уже существующую функциональность, но с некоторыми дополнительными особенностями вроде автонумерации или иного оформления.
Иногда можно создать обёртку шаблона-карточки, но практика спорна и, по мнению некоторых участников, напрасно усложняет техподдержку шаблонов. Тем не менее, полезно делать импортёры карточек для переноса карточек из английского или другого подходящего раздела; в отличие от обычных шаблонов-карточек и их обёрток, импортёры используются с подстановкой.
Функциональность
Желательно ограничивать число параметров разумным количеством, не превращая карточки в таблицы технических характеристик и маловажных деталей;
- и напротив, желательно сделать достаточно общие параметры, чтобы можно было использовать шаблон-карточку в широком кругу статей, и при необходимости задать различные заготовки для копирования для разных типов объектов;
- необходимость прятать часть данных в скрываемые блоки — признак того, что карточка перегружена (исключение — обеспечение доступности путём дублирования редких символов картинкой, как в {{Звук}}); кроме того, скрываемые блоки не работают в мобильной версии.
Не следует использовать технические трюки, усложняющие код и не дающие заметной пользы — благодаря им накапливается технический долг;
- пример такого нежелательного трюка — автовикификация, то есть оборачивание параметра в квадратные скобки в самом шаблоне, а не при его вызове:
| текст1 = [[{{{параметр|}}}]]
сокращающая заполнение на четыре символа в простых случаях, но принуждающая писать эзотерический код вроде
| параметр = Кошечкино (значения){{!}}Кошечкино{{ъъ}}, {{хх}}Собачкино (значения){{!}}Собачкино
в более сложных, например при перечислении нескольких значений. Вариант с предварительной проверкой на наличие статьи, вроде
| текст1 = {{#ifexist: {{{параметр|}}} | [[{{{параметр}}}]] | {{{параметр|}}} }}
тоже плох — поведение шаблона-карточки будет отличаться в зависимости от того, введено в параметр одно значение или же несколько, разделённых запятой, что неинтуитивно.
Не следует задавать значением по умолчанию значение неизвестно: например, появление «автор: неизвестно» в статье о произведении, автор которого не указан в карточке, но известен человечеству, некорректно;
- также не следует делать обязательных параметров, кроме тех, которые действительно необходимы; так, хотя оригинал имени можно заполнить у любого китайского императора, карточка, у которой этот параметр незаполнен, не должна показывать читателям что-то вроде
{{{оригинал имени}}}
— используйте взамен отслеживающие категории.
Нежелательно включение единиц измерения в параметры: использование
| длина, м = 5
вместо
| длина = 5 м
только усложняет ситуацию, когда нужно указать сноску или несколько значений для разных контекстов в одном поле.
Не экономьте на длине параметров — если в карточке дифференциального уравнения нужно указывать область определения, называйте поле именно так, а не просто область, даже если других областей в шаблоне-карточке не предвидится.
Желательно согласовать название параметров с другими шаблонами-карточками.
Категории
Карточками могут проставляться как чисто статейные категории, вроде Категория:Мединские суры, так и служебные категории. Обычно это либо категории «по алфавиту» (например, Категория:Персоналии по алфавиту), с помощью которых можно следить за добавлениями карточки в статьи, либо отслеживающие категории (типа Категория:Футбол:Статьи с карточками без карьеры), помогающие отслеживать популярные ошибки.
Категории, добавляемые шаблоном, обычно указывают после кода самой карточки; их следует оборачивать, чтобы они не отображались вне основного пространства имён, а также чтобы была возможность отключить категории вручную параметром nocat — например, если карточка указана в подразделе статьи. Это можно сделать примерно следующим кодом<:
}}<!-- -->{{#if: {{NAMESPACE}}{{{nocat|}}} || <!-- -->[[Категория:Котики по алфавиту]]<!-- -->{{#if: {{{клубы|}}}{{{футбольная деятельность|}}}{{{тренерские клубы|}}} || [[Категория:Футбол:Статьи с карточками без карьеры]] }}<!-- --> }}<noinclude>{{doc}}</noinclude>
Комментарии <!-- -->
нужны, чтобы не добавлялись пустые строки: два перевода строки в коде после карточки приведут к появлению пустой строки перед преамбулой в тексте статьи.
Иногда полезно изменять ключ сортировки по умолчанию, убирая некоторый стандартный фрагмент из начала названия — например, «The» из начала музыкальных альбомов или «Улица» из начала улиц. Для этого можно использовать подобный код[4]:
{{#ifeq: {{str left|{{PAGENAME}}|4}} | The{{sp}} | {{DEFAULTSORT:{{Без начала|{{PAGENAME}}|The}}}} }}
Документация
Для карточек следует создавать документацию, при этом не inline-овую (через {{doc-inline}}), а вынесенную на отдельную страницу (через {{doc}}).
Желательно заполнить TemplateData — это позволяет редактировать карточку в визуальном редакторе и упрощает её документирование путём использования шаблонов {{Заготовка шаблона}} и {{Пример шаблона}}.
Нужно добавить в шаблон подходящие подкатегории категории Шаблоны-карточки — как тематические, вроде Шаблоны-карточки:Математика и Шаблоны-карточки:Спорт, так и типовые, вроде Шаблоны-карточки:Организации и Шаблоны-карточки:События.
Указать отслеживающие категории можно в отдельном разделе «Отслеживающие категории» с использованием шаблона {{Категория с размером}}.
Если шаблон-карточка в значительной степени использует модуль Lua, то следует проставить {{onLua}}. Для точечных использований вроде вызовов строковых функций из модуля String этого делать не стоит, даже с параметром |partly=1
.
Оформление
Параметры обычно именуются на русском языке и в формате оригинал имени (не Оригинал имени, оригинал_имени, ОригИм и т. д.);
- большинство шаблонов-карточек именуются без слова «карточка», в отличие от других разделов, где обычно добавляется слово «infobox».
Размер шрифта в карточках уже уменьшен по сравнению с размером его в статье, поэтому не следует его дополнительно уменьшать, см. соответствующее правило;
- в целом в ручной регулировке шрифтов при правильной разметке обычно нет необходимости — так, в поле вверху автоматически отображается размер 125 %.
Нужно проверять работу любого задаваемого вручную оформления в нестандартных скинах — обязательно в MinervaNeue, использующемся в мобильной версии[5], но лучше и в MonoBook, которые ранее был основным скином и всё ещё широко используется зарегистрированными участниками.
Цвета
Вверху | |
---|---|
англ. In the header | |
Первый заголовок | |
Первая метка | первый текст |
Вторая метка | второй текст |
Третья метка | третий текст |
По умолчанию у карточек заголовки и иные блоки имеют голубоватый оттенок, использующий цвета, основанные на стандартном оформлении навигационных таблиц (синяя схема). Как примеры см. шаблоны-карточки {{Компания}} и {{Автомобиль}}.
Если в карточке нет поля для изображений и нет поля «заголовок1», или если присутствует поле «вверху3», то для выделения поля «вверху2» можно добавить
| класс_вверху2 = infobox-header
или
| класс_вверху2 = infobox-subheader
в случае, если вам нужно два заголовка разного уровня[6].
В противном случае этого делать не рекомендуется, поскольку пространство между «вверху» и изображением или полем «заголовок1» достаточно выделяет поле «вверху2».
Вверху | |
---|---|
англ. In the header | |
Первый заголовок | |
Первая метка | первый текст |
Вторая метка | второй текст |
Третья метка | третий текст |
Серая схема — одноцветная схема оформления, использующая цвет #eaecf0
.
Эта схема задаётся так:
| цвет = 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.
Использование иных стилей не рекомендуется.
См. также
- en:Wikipedia:Manual of Style/Infoboxes
- en:Help:Infobox
- РУ:Шаблоны
- РУ:Навигационные шаблоны
- Категория:Шаблоны-карточки
- {{Карточка}}
Примечания
- ↑ Терминология чётко не зафиксирована и слова «карточка» и «шаблон-карточка» могут использоваться взаимозаменяемо.
- ↑ Хотя шаблон может быть настроен так, чтобы маркеры отображались — заданием
|классN=noplainlist
- ↑ Шаблон-карточка {{Персона}} по многим параметрам является де-факто стандартом для шаблонов-карточек.
- ↑ Возможно, также можно использовать модуль AdjustSortKey, но лучше сначала обернуть его в шаблон.
- ↑ Но скин MinervaNeue может использоваться и без мобильной версии, поэтому желательно проверить наличие ru.m.wikipedia.org вместо ru.wikipedia.org в адресной строке.
- ↑ При использовании заголовков второго уровня желательно явно указать
|автозаголовки=нет
в шаблоне {{Карточка}} на случай, если в будущем значение по умолчанию будет изменено с нет на да.