РуСказки:Шаблоны-карточки: различия между версиями
Andras (обсуждение | вклад) мНет описания правки |
Andras (обсуждение | вклад) мНет описания правки |
||
Строка 14: | Строка 14: | ||
}} | }} | ||
{{-}} | {{-}} | ||
<small>Пример карточки, использующей<br>шаблон-карточку {{ | <small>Пример карточки, использующей<br>шаблон-карточку {{Tl|Компания}}</small> | ||
{{Персона | {{Персона | ||
Строка 29: | Строка 29: | ||
}} | }} | ||
{{-}} | {{-}} | ||
<small>Пример карточки, использующей<br>шаблон-карточку {{ | <small>Пример карточки, использующей<br>шаблон-карточку {{Tl|Персона}}</small> | ||
</div> | </div> | ||
'''Карточки''', или '''инфобоксы''' (от {{lang-en|infobox}}), — информационные блоки, находящиеся в правом верхнем углу статей рядом с [[Википедия:Преамбула|преамбулой]] и кратко перечисляющие основные параметры описываемого объекта. Карточки создаются при помощи специальных [[Википедия:Шаблоны|шаблонов Википедии]], называемых '''шаблонами-карточками'''<ref>Терминология чётко не зафиксирована и слова «карточка» и «шаблон-карточка» могут использоваться взаимозаменяемо.</ref>. | '''Карточки''', или '''инфобоксы''' (от {{lang-en|infobox}}), — информационные блоки, находящиеся в правом верхнем углу статей рядом с [[Википедия:Преамбула|преамбулой]] и кратко перечисляющие основные параметры описываемого объекта. Карточки создаются при помощи специальных [[Википедия:Шаблоны|шаблонов Википедии]], называемых '''шаблонами-карточками'''<ref>Терминология чётко не зафиксирована и слова «карточка» и «шаблон-карточка» могут использоваться взаимозаменяемо.</ref>. | ||
Строка 38: | Строка 38: | ||
Цель карточек — '''''приводить ключевые факты из основного текста статьи, а не замещать его'''''. В частности, статья не должна стать неполной после скрытия из неё карточки. Чтобы ключевые факты были легко заметны, карточка должна содержать только небольшое количество полей, а эти поля должны быть заполнены кратко и ёмко. | Цель карточек — '''''приводить ключевые факты из основного текста статьи, а не замещать его'''''. В частности, статья не должна стать неполной после скрытия из неё карточки. Чтобы ключевые факты были легко заметны, карточка должна содержать только небольшое количество полей, а эти поля должны быть заполнены кратко и ёмко. | ||
Тем не менее, в некоторых случаях важную специализированную информацию сложно интегрировать в текст статьи, а в карточке она может быть уместна. Например, таковы промежуточные [[Ранг (биология)|ранги]] в шаблоне {{ | Тем не менее, в некоторых случаях важную специализированную информацию сложно интегрировать в текст статьи, а в карточке она может быть уместна. Например, таковы промежуточные [[Ранг (биология)|ранги]] в шаблоне {{Tl|Таксон}} и основные математические характеристики в шаблоне {{Tl|Граф}}. Также в карточках без повторения в основном тексте может находиться часто обновляемая информация, хранимая на [[Википедия:Викиданные|Викиданных]], такая как версия в шаблоне {{Tl|Программа}}. | ||
Не следует добавлять в карточки большое количество технических данных и ссылки на разделы статей — для этого есть таблицы с характеристиками и содержание соответственно. Потребность в скрываемых блоках — верный признак того, что карточка перегружена. | Не следует добавлять в карточки большое количество технических данных и ссылки на разделы статей — для этого есть таблицы с характеристиками и содержание соответственно. Потребность в скрываемых блоках — верный признак того, что карточка перегружена. | ||
Строка 87: | Строка 87: | ||
=== Викиданные === | === Викиданные === | ||
[[Файл: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]], к которому привязана статья [[Адамс, Дуглас]] русской Википедии]] | [[Файл: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>Существует карточка, которая вообще не имеет параметров и всё берёт из Викиданных, {{ | Карточка в статье может брать некоторую информацию из [[Википедия:Викиданные|Викиданных]], если в соответствующем шаблоне-карточке подключено соответствующее свойство Викиданных<ref>В русском разделе у большинства шаблонов-карточек подключено несколько свойств, а в других разделах, в частности в английском, это может быть редкостью.</ref><ref>Существует карточка, которая вообще не имеет параметров и всё берёт из Викиданных, {{Tl|универсальная карточка}}, однако её следует использовать только тогда, когда нет более подходящей карточки, см. подробности в её документации.</ref>. | ||
Если в статье задано локальное значение, то есть значение параметра в вызове шаблона-карточки, то в карточке используется именно оно, переопределяя значение с Викиданных. Чтобы просмотреть заполненные свойства Викиданных, нажмите ''Элемент Викиданных'' в блоке ссылок слева от текста статьи. Откроется страница, подобная [[d:Q42|такой]]. | Если в статье задано локальное значение, то есть значение параметра в вызове шаблона-карточки, то в карточке используется именно оно, переопределяя значение с Викиданных. Чтобы просмотреть заполненные свойства Викиданных, нажмите ''Элемент Викиданных'' в блоке ссылок слева от текста статьи. Откроется страница, подобная [[d:Q42|такой]]. | ||
Строка 104: | Строка 104: | ||
Поскольку карточка может отображать как локально заполненные параметры, так и информацию из Викиданных, во избежание конфликтов, связанных с её очисткой/заполнением, рекомендуется руководствоваться следующими соображениями: | Поскольку карточка может отображать как локально заполненные параметры, так и информацию из Викиданных, во избежание конфликтов, связанных с её очисткой/заполнением, рекомендуется руководствоваться следующими соображениями: | ||
# Не рекомендуется очищать/заполнять карточки в статьях/списках, обладающими статусом ИС/ХС/ДС. В статусных проектах принято оставлять подобные вопросы на усмотрение основного автора статьи. | # Не рекомендуется очищать/заполнять карточки в статьях/списках, обладающими статусом ИС/ХС/ДС. В статусных проектах принято оставлять подобные вопросы на усмотрение основного автора статьи. | ||
# «Статические» параметры, которые навряд ли будут меняться в будущем (например, место погребения в {{ | # «Статические» параметры, которые навряд ли будут меняться в будущем (например, место погребения в {{Tl|Персона}}), можно оставлять в карточке заполненными, не полагаясь на Викиданные. Это позволит тем, кто держит данную статью в списке наблюдения, более эффективно отслеживать вандализм и бороться с ним. Поэтому: | ||
## Если кто-то заменил «статические» сведения на импорт из Викиданных, и ''статья улучшилась'' (стала отображаться точнее или полнее, включая категории) — то это изменение полезное. | ## Если кто-то заменил «статические» сведения на импорт из Викиданных, и ''статья улучшилась'' (стала отображаться точнее или полнее, включая категории) — то это изменение полезное. | ||
## Если кто-то заменил импорт «статических» сведений из Викиданных внесением их в параметры карточки, и ''статья не ухудшилась'' — то это изменение полезное. | ## Если кто-то заменил импорт «статических» сведений из Викиданных внесением их в параметры карточки, и ''статья не ухудшилась'' — то это изменение полезное. | ||
# «Динамические» сведения, которые могут уточняться со временем (например, номер последней версии в {{ | # «Динамические» сведения, которые могут уточняться со временем (например, номер последней версии в {{Tl|Программа}}), чаще всего более актуальны в Викиданных, нежели в Википедии; такие параметры рекомендуется оставлять в карточке незаполненными, проводя их указание/актуализацию в ВД. Убирание такого параметра из карточки для автоматической загрузки его из Викиданных, считается полезным действием при условии, что после изменения статья отображается корректно (включая оформление сносок). | ||
# В остальных случаях изменения в карточках ''можно'' отменять как возврат к консенсусному состоянию статьи, дополнительно отсылая оппонента к данному тексту. | # В остальных случаях изменения в карточках ''можно'' отменять как возврат к консенсусному состоянию статьи, дополнительно отсылая оппонента к данному тексту. | ||
Строка 116: | Строка 116: | ||
==== Оригинал названия или имени ==== | ==== Оригинал названия или имени ==== | ||
Поля для оригинальных названий и имён заполняются при помощи шаблонов серии {{ | Поля для оригинальных названий и имён заполняются при помощи шаблонов серии {{Tl|lang-en}}: | ||
{{карточка | {{карточка | ||
| стиль_вверху = background:#cfe3ff; | | стиль_вверху = background:#cfe3ff; | ||
Строка 165: | Строка 165: | ||
</pre> | </pre> | ||
При заполнении в таком формате автоматически считается текущий возраст или возраст на момент смерти<ref>При условии, что параметры используют шаблоны {{ | При заполнении в таком формате автоматически считается текущий возраст или возраст на момент смерти<ref>При условии, что параметры используют шаблоны {{Tl|wikidata/p569}} и {{Tl|wikidata/p570}}.</ref>. | ||
Некоторые иные даты так же указываются в таком формате, в то же самое время другие указываются как <code><nowiki>[[дд месяца]] [[гггг]]</nowiki></code>. | Некоторые иные даты так же указываются в таком формате, в то же самое время другие указываются как <code><nowiki>[[дд месяца]] [[гггг]]</nowiki></code>. | ||
==== Перечисление маркированным списком ==== | ==== Перечисление маркированным списком ==== | ||
Некоторые поля заполняют не через запятую, а в столбик, перенося строки — например, главные роли в шаблоне {{ | Некоторые поля заполняют не через запятую, а в столбик, перенося строки — например, главные роли в шаблоне {{Tl|Фильм}}. Для этого можно использовать маркированные списки, но при этом маркеры обычно отображаться не будут<ref>Хотя шаблон может быть настроен так, чтобы маркеры отображались — заданием {{para|классN|noplainlist}}</ref>. | ||
{{карточка | {{карточка | ||
Строка 190: | Строка 190: | ||
==== Медали или награды ==== | ==== Медали или награды ==== | ||
Поле ''медали'' или ''награды'' можно заполнять при помощи шаблона {{ | Поле ''медали'' или ''награды'' можно заполнять при помощи шаблона {{Tl|ряд-л}}, например: | ||
{{карточка | {{карточка | ||
|стиль_меток = width:10em; | |стиль_меток = width:10em; | ||
Строка 234: | Строка 234: | ||
</pre> | </pre> | ||
Шаблон {{ | Шаблон {{Tl|URL}} для этого не нужен<ref>При условии, что параметр подключен к полю {{WD|P856}} Викиданных.</ref>. | ||
==== Категория на Викискладе ==== | ==== Категория на Викискладе ==== | ||
Строка 242: | Строка 242: | ||
Создание и редактирование шаблонов-карточек требует как технических, так и метапедических навыков и рекомендуется только для опытных участников. В любом случае желательно предварительно проверять свои правки путём [[Википедия:Правка и тестирование шаблонов в песочнице|тестирования на подстранице-песочнице]]. Полезно использовать [[Участник:Jack who built the house/Code Prettifier|скрипт для оформления кода]]. | Создание и редактирование шаблонов-карточек требует как технических, так и метапедических навыков и рекомендуется только для опытных участников. В любом случае желательно предварительно проверять свои правки путём [[Википедия:Правка и тестирование шаблонов в песочнице|тестирования на подстранице-песочнице]]. Полезно использовать [[Участник:Jack who built the house/Code Prettifier|скрипт для оформления кода]]. | ||
Некоторые примеры шаблонов-карточек — {{ | Некоторые примеры шаблонов-карточек — {{Tl|Персона}}<ref>Шаблон-карточка {{Tl|Персона}} по многим параметрам является де-факто стандартом для шаблонов-карточек.</ref>, {{Tl|Художник}}, {{Tl|Компания}}, {{Tl|Язык}}, {{Tl|Единица измерения}} и {{Tl|Структура данных}}. | ||
=== Создание шаблонов === | === Создание шаблонов === | ||
Основное, что нужно знать перед созданием шаблонов-карточек — '''''большинство необходимых шаблонов-карточек уже создано'''''. Если вы не можете найти подходящий, попробуйте спросить на [[Википедия:Форум/Вопросы|форуме вопросов]]. Возможно, подходящий шаблон-карточка уже существует или вместо его создания следует обобщить и дополнить другой шаблон-карточку. | Основное, что нужно знать перед созданием шаблонов-карточек — '''''большинство необходимых шаблонов-карточек уже создано'''''. Если вы не можете найти подходящий, попробуйте спросить на [[Википедия:Форум/Вопросы|форуме вопросов]]. Возможно, подходящий шаблон-карточка уже существует или вместо его создания следует обобщить и дополнить другой шаблон-карточку. | ||
Тем не менее, если вы опытный участник Википедии и абсолютно уверены в необходимости создать шаблон-карточку, вы можете сделать это с использованием меташаблона {{ | Тем не менее, если вы опытный участник Википедии и абсолютно уверены в необходимости создать шаблон-карточку, вы можете сделать это с использованием меташаблона {{Tl|Карточка}} — техническая инструкция содержится на соответствующей странице. Не следует использовать таблицы или меташаблоны вида {{Tl|Что-то там/строка}}. | ||
Полезно поискать подходящий шаблон-карточку в английской, французской или иной крупной Википедии, перейдя по [[Википедия:Интервики|интервикам]], и взять за образец его параметры. Но лучше не копировать его код и оформление — нормы последних в разных разделах могут весьма отличаться. | Полезно поискать подходящий шаблон-карточку в английской, французской или иной крупной Википедии, перейдя по [[Википедия:Интервики|интервикам]], и взять за образец его параметры. Но лучше не копировать его код и оформление — нормы последних в разных разделах могут весьма отличаться. | ||
Строка 258: | Строка 258: | ||
Желательно ограничивать число параметров разумным количеством, не превращая карточки в таблицы технических характеристик и маловажных деталей; | Желательно ограничивать число параметров разумным количеством, не превращая карточки в таблицы технических характеристик и маловажных деталей; | ||
* и напротив, желательно сделать достаточно общие параметры, чтобы можно было использовать шаблон-карточку в широком кругу статей, и при необходимости задать различные заготовки для копирования для разных типов объектов; | * и напротив, желательно сделать достаточно общие параметры, чтобы можно было использовать шаблон-карточку в широком кругу статей, и при необходимости задать различные заготовки для копирования для разных типов объектов; | ||
* необходимость прятать часть данных в скрываемые блоки — признак того, что карточка перегружена (исключение — обеспечение доступности путём дублирования редких символов картинкой, как в {{ | * необходимость прятать часть данных в скрываемые блоки — признак того, что карточка перегружена (исключение — обеспечение доступности путём дублирования редких символов картинкой, как в {{Tl|Звук}}); кроме того, скрываемые блоки не работают в мобильной версии. | ||
Не следует использовать технические трюки, усложняющие код и не дающие заметной пользы — благодаря им накапливается [[технический долг]]; | Не следует использовать технические трюки, усложняющие код и не дающие заметной пользы — благодаря им накапливается [[технический долг]]; | ||
Строка 302: | Строка 302: | ||
==== Викиданные ==== | ==== Викиданные ==== | ||
Подключите подходящие свойства [[Википедия:Викиданные|Викиданных]]. В русской Википедии принята широкая интеграция с Викиданными, при которой подключается большинство свойств, которые возможно использовать в карточках<ref>Во французской Википедии и некоторых более мелких разделах также берётся информация с Викиданных, но в очень разных масштабах. В английской Википедии Викиданные практически не используются в карточках, а там, где используется, требуется обязательное указание источника на Викиданных.</ref> — хотя, например, некоторые свойства вроде {{WD|P136}} и {{WD|P172}} обычно не применяются из-за повышенного риска [[Википедия:Недопустимость оригинальных исследований|ориссности]], а некоторые другие свойства не используются по техническим причинам<ref>Например, нет возможности импортировать {{WD|P39}} вместе с квалификаторами в виде, нужном для шаблона {{ | Подключите подходящие свойства [[Википедия:Викиданные|Викиданных]]. В русской Википедии принята широкая интеграция с Викиданными, при которой подключается большинство свойств, которые возможно использовать в карточках<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> | <pre> | ||
| метка1 = Метка | | метка1 = Метка | ||
Строка 326: | Строка 326: | ||
При этом часто такие настройки одинаковы для всех включений свойства в карточках, поэтому лучше добавить их в общие настройки на странице [[Модуль:Wikidata/config]]<ref>Запросить добавление можно на странице [[Википедия:Технические запросы]]</ref>. | При этом часто такие настройки одинаковы для всех включений свойства в карточках, поэтому лучше добавить их в общие настройки на странице [[Модуль:Wikidata/config]]<ref>Запросить добавление можно на странице [[Википедия:Технические запросы]]</ref>. | ||
Если необходимо использовать карточку несколько раз в статье, то взятие данных из нужного элемента Викиданных можно настроить при помощи параметра ''from''; при этом его нужно пробросить в шаблон {{ | Если необходимо использовать карточку несколько раз в статье, то взятие данных из нужного элемента Викиданных можно настроить при помощи параметра ''from''; при этом его нужно пробросить в шаблон {{Tl|Wikidata}}, а в параметры ''викиданныеN'' он передастся автоматически: | ||
<pre> | <pre> | ||
{{Карточка | {{Карточка | ||
Строка 344: | Строка 344: | ||
</pre> | </pre> | ||
В первую очередь будет браться информация из свойства P123, и лишь потом — из свойства P234<ref>Использование #ifeq необходимо для того, чтобы работало отключение взятия информации через минус, а иначе внутренний шаблон {{ | В первую очередь будет браться информация из свойства P123, и лишь потом — из свойства P234<ref>Использование #ifeq необходимо для того, чтобы работало отключение взятия информации через минус, а иначе внутренний шаблон {{Tl|Wikidata}} оборачивает минус в служебные тэги, а внешний перестаёт воспринимать его как минус.</ref><ref>Возможно, следует внедрить поддержку перечисления свойств через точку с запятой в параметрах ''викиданныеN'' шаблона {{Tl|Карточка}}</ref>. | ||
Можно также добавить служебные тэги, позволяющие быстро импортировать информацию из Википедии на Викиданные через специальный гаджет, см. {{Настройки|Gadgets|Быстрое добавление информации из карточек в Викиданные}}, но без подключения отображения информации с Викиданных в статьях. Для этого следует написать | Можно также добавить служебные тэги, позволяющие быстро импортировать информацию из Википедии на Викиданные через специальный гаджет, см. {{Настройки|Gadgets|Быстрое добавление информации из карточек в Викиданные}}, но без подключения отображения информации с Викиданных в статьях. Для этого следует написать | ||
Строка 354: | Строка 354: | ||
===== Изображения ===== | ===== Изображения ===== | ||
Стандартный способ добавлять изображение в шаблон-карточку — при помощи шаблона {{ | Стандартный способ добавлять изображение в шаблон-карточку — при помощи шаблона {{Tl|wikidata}} с указанием подходящего свойства Викиданных: | ||
<pre> | <pre> | ||
| изображение = {{wikidata|P18|{{{изображение|}}}|caption={{{описание изображения|}}}|size={{{ширина|}}}}} | | изображение = {{wikidata|P18|{{{изображение|}}}|caption={{{описание изображения|}}}|size={{{ширина|}}}}} | ||
Строка 367: | Строка 367: | ||
Обычно не требуется переопределять в шаблоне-карточке стандартные размеры изображения из модуля [[Модуль:Wikidata|Wikidata]], они уже подогнаны для разных свойств Викиданных, см. [[#Параметры]] выше. Добавлять размер изображения в стандартную заготовку для копирования не рекомендуется, поскольку в статьях его обычно нет нужды использовать, а при добавлении его будут указывать повсеместно. | Обычно не требуется переопределять в шаблоне-карточке стандартные размеры изображения из модуля [[Модуль:Wikidata|Wikidata]], они уже подогнаны для разных свойств Викиданных, см. [[#Параметры]] выше. Добавлять размер изображения в стандартную заготовку для копирования не рекомендуется, поскольку в статьях его обычно нет нужды использовать, а при добавлении его будут указывать повсеместно. | ||
Помимо свойств {{WD|P18}} и {{WD|P154}} есть другие [[d:Special:ListProperties/commonsMedia|медиа-свойства Викиданных]]. Если нет подходящего свойства Викиданных, можно использовать шаблон {{ | Помимо свойств {{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> | <pre> | ||
{{#if: {{wikidata|P123|{{{параметр|}}}|plain=true}} | если есть | если нет }} | {{#if: {{wikidata|P123|{{{параметр|}}}|plain=true}} | если есть | если нет }} | ||
Строка 404: | Строка 404: | ||
</pre> | </pre> | ||
Один из видов отслеживающих категорий — содержащие страницы, вызывающие неизвестные параметры шаблона. Такую категорию можно установить в шаблоне добавлением {{ | Один из видов отслеживающих категорий — содержащие страницы, вызывающие неизвестные параметры шаблона. Такую категорию можно установить в шаблоне добавлением {{Tl|cfup|s}} между кодом самой карточки и кодом добавляемых ею категорий, см. модуль [[Модуль:Check for unknown parameters|Check for unknown parameters]]. | ||
Для категоризации объектов по году, вроде [[:Категория:Компании, основанные в 1984 году]], можно использовать шаблон {{ | Для категоризации объектов по году, вроде [[:Категория:Компании, основанные в 1984 году]], можно использовать шаблон {{Tl|Категория по дате}}. | ||
Иногда полезно изменять ключ сортировки по умолчанию, убирая некоторый стандартный фрагмент из начала названия — например, «The» из начала музыкальных альбомов или «Улица» из начала улиц. Для этого можно использовать подобный код<ref>Возможно, также можно использовать модуль [[Модуль:AdjustSortKey|AdjustSortKey]], но лучше сначала обернуть его в шаблон.</ref>: | Иногда полезно изменять ключ сортировки по умолчанию, убирая некоторый стандартный фрагмент из начала названия — например, «The» из начала музыкальных альбомов или «Улица» из начала улиц. Для этого можно использовать подобный код<ref>Возможно, также можно использовать модуль [[Модуль:AdjustSortKey|AdjustSortKey]], но лучше сначала обернуть его в шаблон.</ref>: | ||
Строка 415: | Строка 415: | ||
==== Меташаблоны ==== | ==== Меташаблоны ==== | ||
При необходимости используйте меташаблоны: | При необходимости используйте меташаблоны: | ||
* для добавления различных стандартизированных блоков используйте [[Шаблон:Подстраницы шаблона Карточка|подстраницы шаблона Карточка]]; например, {{ | * для добавления различных стандартизированных блоков используйте [[Шаблон:Подстраницы шаблона Карточка|подстраницы шаблона Карточка]]; например, {{Tl|Карточка/название}} вверху и {{Tl|Карточка/Викисклад}} внизу карточки соответственно; | ||
* если требуется отображать метки в разном роде — ''родилась'' или ''родился'' — в зависимости от {{WD|P21}}, используйте {{ | * если требуется отображать метки в разном роде — ''родилась'' или ''родился'' — в зависимости от {{WD|P21}}, используйте {{Tl|Wikidata gender switch}}; | ||
* если требуется отображать метки в разном числе — ''параметр'' или ''параметры'' — в зависимости от того, заполнено ли одно значение или несколько, используйте {{ | * если требуется отображать метки в разном числе — ''параметр'' или ''параметры'' — в зависимости от того, заполнено ли одно значение или несколько, используйте {{Tl|Wikidata number switch}}; | ||
* если нужно перечислить несколько параметров через запятую или перенос строки, но некоторые из них могут отсутствовать, используйте {{ | * если нужно перечислить несколько параметров через запятую или перенос строки, но некоторые из них могут отсутствовать, используйте {{Tl|comma separated entries}} или {{Tl|br separated entries}} соответственно; | ||
==== Документация ==== | ==== Документация ==== | ||
Для карточек следует создавать [[Википедия:Документация шаблонов|документацию]], при этом не inline-овую (через {{ | Для карточек следует создавать [[Википедия:Документация шаблонов|документацию]], при этом не inline-овую (через {{Tl|doc-inline}}), а вынесенную на отдельную страницу (через {{Tl|doc}}). | ||
Желательно заполнить [[Википедия:TemplateData|TemplateData]] — это позволяет редактировать карточку в [[Википедия:Визуальный редактор|визуальном редакторе]] и упрощает её документирование путём использования шаблонов {{ | Желательно заполнить [[Википедия:TemplateData|TemplateData]] — это позволяет редактировать карточку в [[Википедия:Визуальный редактор|визуальном редакторе]] и упрощает её документирование путём использования шаблонов {{Tl|Заготовка шаблона}} и {{Tl|Пример шаблона}}. | ||
Нужно добавить в шаблон подходящие подкатегории категории [[:Категория:Шаблоны-карточки|Шаблоны-карточки]] — как тематические, вроде [[:Категория:Шаблоны-карточки:Математика|<nowiki>Шаблоны-карточки:Математика</nowiki>]] и [[:Категория:Шаблоны-карточки:Спорт|<nowiki>Шаблоны-карточки:Спорт</nowiki>]], так и типовые, вроде [[:Категория:Шаблоны-карточки:Организации|<nowiki>Шаблоны-карточки:Организации</nowiki>]] и [[:Категория:Шаблоны-карточки:События|<nowiki>Шаблоны-карточки:События</nowiki>]]. | Нужно добавить в шаблон подходящие подкатегории категории [[:Категория:Шаблоны-карточки|Шаблоны-карточки]] — как тематические, вроде [[:Категория:Шаблоны-карточки:Математика|<nowiki>Шаблоны-карточки:Математика</nowiki>]] и [[:Категория:Шаблоны-карточки:Спорт|<nowiki>Шаблоны-карточки:Спорт</nowiki>]], так и типовые, вроде [[:Категория:Шаблоны-карточки:Организации|<nowiki>Шаблоны-карточки:Организации</nowiki>]] и [[:Категория:Шаблоны-карточки:События|<nowiki>Шаблоны-карточки:События</nowiki>]]. | ||
Указать отслеживающие категории можно в отдельном разделе «Отслеживающие категории» с использованием шаблона {{ | Указать отслеживающие категории можно в отдельном разделе «Отслеживающие категории» с использованием шаблона {{Tl|Категория с размером}}. | ||
Если шаблон-карточка в значительной степени использует модуль Lua, то следует проставить {{ | Если шаблон-карточка в значительной степени использует модуль Lua, то следует проставить {{Tl|onLua}}. Для точечных использований вроде вызовов строковых функций из модуля [[Модуль:String|String]] этого делать не стоит, даже с параметром {{para|partly|1}}. | ||
=== Оформление === | === Оформление === | ||
Строка 459: | Строка 459: | ||
По умолчанию у карточек заголовки и иные блоки имеют голубоватый оттенок, использующий цвета, основанные на стандартном оформлении [[Шаблон:Навигационная таблица|навигационных таблиц]] ('''синяя схема'''). Используемая палитра близка к [https://design.wikimedia.org/style-guide/visual-style_colors.html#accent-colors акцентным цветам] из руководства по стилю от [[Фонд Викимедиа|Фонда Викимедиа]]. Для её использования не нужно заполнять никакие дополнительные параметры. | По умолчанию у карточек заголовки и иные блоки имеют голубоватый оттенок, использующий цвета, основанные на стандартном оформлении [[Шаблон:Навигационная таблица|навигационных таблиц]] ('''синяя схема'''). Используемая палитра близка к [https://design.wikimedia.org/style-guide/visual-style_colors.html#accent-colors акцентным цветам] из руководства по стилю от [[Фонд Викимедиа|Фонда Викимедиа]]. Для её использования не нужно заполнять никакие дополнительные параметры. | ||
Как примеры см. шаблоны-карточки {{ | Как примеры см. шаблоны-карточки {{Tl|Компания}} и {{Tl|Автомобиль}}. | ||
Если в карточке нет поля для изображений и нет поля «заголовок1», или если присутствует поле «вверху3», то для выделения поля «вверху2» можно добавить | Если в карточке нет поля для изображений и нет поля «заголовок1», или если присутствует поле «вверху3», то для выделения поля «вверху2» можно добавить | ||
Строка 469: | Строка 469: | ||
| класс_вверху2 = infobox-subheader | | класс_вверху2 = infobox-subheader | ||
</pre> | </pre> | ||
в случае, если вам нужно два заголовка разного уровня<ref>При использовании заголовков второго уровня желательно явно указать {{para|автозаголовки|нет}} в шаблоне {{ | в случае, если вам нужно два заголовка разного уровня<ref>При использовании заголовков второго уровня желательно явно указать {{para|автозаголовки|нет}} в шаблоне {{Tl|Карточка}} на случай, если в будущем значение по умолчанию будет изменено с ''нет'' на ''да''.</ref>. | ||
В противном случае этого делать не рекомендуется, поскольку пространство между «вверху» и изображением или полем «заголовок1» достаточно выделяет поле «вверху2». | В противном случае этого делать не рекомендуется, поскольку пространство между «вверху» и изображением или полем «заголовок1» достаточно выделяет поле «вверху2». | ||
Строка 498: | Строка 498: | ||
Дополнительных цветов для поля «вверху2» и заголовков второго уровня нет, в отличие от синей схемы. | Дополнительных цветов для поля «вверху2» и заголовков второго уровня нет, в отличие от синей схемы. | ||
Как примеры см. шаблон-карточку {{ | Как примеры см. шаблон-карточку {{Tl|Учёный}}. | ||
Так же могут использоваться другие схемы, одобренные для использования тематическими проектами. Для каждой такой схемы должна быть создана подстраница шаблона {{ | Так же могут использоваться другие схемы, одобренные для использования тематическими проектами. Для каждой такой схемы должна быть создана подстраница шаблона {{Tl|Цвет}}. | ||
==== Прочие стили ==== | ==== Прочие стили ==== | ||
Строка 510: | Строка 510: | ||
</pre> | </pre> | ||
Хотя использование скрываемых блоков в общем случае не рекомендуется, иногда они нужны — например, для обеспечения доступности путём дублирования редких символов картинкой, как в шаблоне {{ | Хотя использование скрываемых блоков в общем случае не рекомендуется, иногда они нужны — например, для обеспечения доступности путём дублирования редких символов картинкой, как в шаблоне {{Tl|Звук}}. В таком случае можно оформить скрываемый блок так, чтобы его заголовок выглядел как подзаголовки в самой карточке. Это делается при помощи шаблона {{Tl|Начало скрытого блока}} c такими параметрами: | ||
<pre> | <pre> | ||
| текст1 = {{Начало скрытого блока | | текст1 = {{Начало скрытого блока | ||
Строка 524: | Строка 524: | ||
</pre> | </pre> | ||
Маркированные подпараметры можно оформить с помощью {{ | Маркированные подпараметры можно оформить с помощью {{Tl|Карточка/блок с маркерами}}. При этом не рекомендуется ими злоупотреблять — заголовки часто предпочтительнее. | ||
Рекомендуется использовать стандартную ширину карточки — 23em (явно указывать не требуется), но при необходимость можно использовать 27em или 19em. | Рекомендуется использовать стандартную ширину карточки — 23em (явно указывать не требуется), но при необходимость можно использовать 27em или 19em. | ||
Строка 531: | Строка 531: | ||
==== Ссылки на статьи в других языковых разделах ==== | ==== Ссылки на статьи в других языковых разделах ==== | ||
При использовании в карточках ссылок на другие языковые разделы следует использовать шаблон {{ | При использовании в карточках ссылок на другие языковые разделы следует использовать шаблон {{Tl|iw}}. Использование шаблонов {{Tl|нп1}}, {{Tl|нп2}}, {{Tl|нп3}} и {{Tl|нп4}} неконсистентно со ссылками, генерируемыми при вызове значений из Викиданных. Также крайне не рекомендуется использовать прямые вики-ссылки вида <code><nowiki>[[:en:article|статья]]</nowiki></code>. | ||
== См. также == | == См. также == | ||
Строка 550: | Строка 550: | ||
'''Прочие полезные страницы''' | '''Прочие полезные страницы''' | ||
* {{ | * {{Tl|Карточка}} | ||
* {{ | * {{Tl|Wikidata}} | ||
* [[Участник:Jack who built the house/Code Prettifier]] | * [[Участник:Jack who built the house/Code Prettifier]] | ||
Версия от 13:02, 12 февраля 2024
![]() | Эта страница требует существенной переработки. |
Шаблон:Информационная страница
Шаблон:Компания
Шаблон:-
Пример карточки, использующей
шаблон-карточку {{Компания}}
Шаблон:Персона
Шаблон:-
Пример карточки, использующей
шаблон-карточку {{Персона}}
Карточки, или инфобоксы (от Шаблон:lang-en), — информационные блоки, находящиеся в правом верхнем углу статей рядом с преамбулой и кратко перечисляющие основные параметры описываемого объекта. Карточки создаются при помощи специальных шаблонов Википедии, называемых шаблонами-карточками[1].
Они вставляются в вики-код статьи копированием заготовки или через визуальный редактор. Шаблоны-карточки могут использовать данные не только из параметров шаблона, но и из Викиданных. Найти шаблон-карточку для вставки карточки в статью можно в подходящей подкатегории категории Шаблоны-карточки или в близкой по тематике статье.
Цель карточек
Цель карточек — приводить ключевые факты из основного текста статьи, а не замещать его. В частности, статья не должна стать неполной после скрытия из неё карточки. Чтобы ключевые факты были легко заметны, карточка должна содержать только небольшое количество полей, а эти поля должны быть заполнены кратко и ёмко.
Тем не менее, в некоторых случаях важную специализированную информацию сложно интегрировать в текст статьи, а в карточке она может быть уместна. Например, таковы промежуточные ранги в шаблоне {{Таксон}} и основные математические характеристики в шаблоне {{Граф}}. Также в карточках без повторения в основном тексте может находиться часто обновляемая информация, хранимая на Викиданных, такая как версия в шаблоне {{Программа}}.
Не следует добавлять в карточки большое количество технических данных и ссылки на разделы статей — для этого есть таблицы с характеристиками и содержание соответственно. Потребность в скрываемых блоках — верный признак того, что карточка перегружена.
Обратите внимание, что не в каждой статье обязательна карточка. Иногда отсутствие карточки — это нормальное явление, связанное с тем, что карточки перечисляют данные, типичные для схожих статей, а потому, например, в статьях об абстрактных или нетиповых понятиях им нечего описывать[2].
Использование шаблонов-карточек
Шаблон:см. также Найти шаблон-карточку для вставки карточки в статью можно в подходящей подкатегории категории Шаблоны-карточки или в близкой по тематике статье.
Обратите внимание, что размещение в статье больше одной карточки не рекомендуется. При необходимости разместить дополнительные карточки в разделах необходимо указать Шаблон:para для отключения указания категорий, а также Шаблон:para для взятия информации Викиданных из нужного элемента[3]. При этом параметр Шаблон:para поддерживается очень небольшим числом карточек.
Режим вики-текста
Для вставки шаблона в режиме редактирования вики-текста необходимо скопировать в начало статьи, но после блока стандартных шаблонных пометок I код заготовки для копирования и заполнить его параметры после знака равенства. Пример заготовки для копирования:
{{Что-то там | название = | оригинал названия = {{lang-XX|}} | страна = | дата появления = дд.мм.гггг }}
При этом некоторые параметры могут быть предзаполнены, и их нужно будет или заполнить до конца, или удалить из заготовки. Пример получившегося:
{{Что-то там | название = Удивительная вещь | оригинал названия = {{lang-fr|Une chose étonnante}} | страна = [[Франция]] | дата появления = }}
Обычно не нужно удалять пустые параметры — если параметр не задан, то соответствующая строка карточки просто не будет отображаться; напротив, если в будущем понадобится заполнить соответствующее поле, оно уже будет в коде статьи. Также не следует использовать подстановку.
Редактировать параметры в уже заполненной карточке можно аналогично. Обратите внимание, что параметры шаблонов-карточек жёстко фиксированы — если в нём есть параметры длина, ширина и высота, но отсутствует параметр глубина, то добавление в код
| глубина = 10 м
не приведёт к отображению чего-либо на странице. Аналогично, замена режиссёр на режиссёры, создатель на создательница или церковь на Церковь при отсутствии соответствующего синонима в шаблоне-карточке только испортит страницу.
Визуальный редактор
Другой способ добавить шаблон-карточку — использовать визуальный редактор. Для этого необходимо выбрать Вставить — Шаблон и заполнить параметры в появившемся окошке. К сожалению, такой способ работает не для всех шаблонов-карточек, поскольку требует наличия TemplateData — но вы можете попросить создать её у некоторого шаблона-карточки на техническом форуме.
При заполнении через визуальный редактор могут отображаться примеры заполнения, значения по умолчанию, подсказки по заполнению и другое. При отсутствии всего этого, да и в любом случае полезно посмотреть документацию на странице шаблона.
Викиданные
Карточка в статье может брать некоторую информацию из Викиданных, если в соответствующем шаблоне-карточке подключено соответствующее свойство Викиданных[4][5].
Если в статье задано локальное значение, то есть значение параметра в вызове шаблона-карточки, то в карточке используется именно оно, переопределяя значение с Викиданных. Чтобы просмотреть заполненные свойства Викиданных, нажмите Элемент Викиданных в блоке ссылок слева от текста статьи. Откроется страница, подобная такой.
На Викиданных удобно настроить русский язык, для этого нужно выбрать Preferences → User profile → Internationalisation. Также полезно подключить гаджет для отображения кликабельных значков Файл:Wikidata-logo.svg рядом с полями карточек, значения которых берутся из Викиданных, перейдя по Шаблон:Настройки. Рядом есть и другие гаджеты для Викиданных.
Научиться заполнять свойства Викиданных можно в интерактивном курсе[6], а другая полезная информация находится на странице часто задаваемых вопросов.
Чтобы отключить свойство Викиданных, ничего не добавляя взамен, используйте в статье значение -
. Например,
| награды = -
скроет награды в карточке — это может быть нужно, если поле с ними слишком большое (но желательно проверить, что награды перечислены в основном тексте, чтобы не потерять полезную информацию). Скрывать данные нужно довольно редко: если они просто некорректны, лучше исправить или спросить на форуме Викиданных.
Удаление/возврат информации из карточки
Поскольку карточка может отображать как локально заполненные параметры, так и информацию из Викиданных, во избежание конфликтов, связанных с её очисткой/заполнением, рекомендуется руководствоваться следующими соображениями:
- Не рекомендуется очищать/заполнять карточки в статьях/списках, обладающими статусом ИС/ХС/ДС. В статусных проектах принято оставлять подобные вопросы на усмотрение основного автора статьи.
- «Статические» параметры, которые навряд ли будут меняться в будущем (например, место погребения в {{Персона}}), можно оставлять в карточке заполненными, не полагаясь на Викиданные. Это позволит тем, кто держит данную статью в списке наблюдения, более эффективно отслеживать вандализм и бороться с ним. Поэтому:
- Если кто-то заменил «статические» сведения на импорт из Викиданных, и статья улучшилась (стала отображаться точнее или полнее, включая категории) — то это изменение полезное.
- Если кто-то заменил импорт «статических» сведений из Викиданных внесением их в параметры карточки, и статья не ухудшилась — то это изменение полезное.
- «Динамические» сведения, которые могут уточняться со временем (например, номер последней версии в {{Программа}}), чаще всего более актуальны в Викиданных, нежели в Википедии; такие параметры рекомендуется оставлять в карточке незаполненными, проводя их указание/актуализацию в ВД. Убирание такого параметра из карточки для автоматической загрузки его из Викиданных, считается полезным действием при условии, что после изменения статья отображается корректно (включая оформление сносок).
- В остальных случаях изменения в карточках можно отменять как возврат к консенсусному состоянию статьи, дополнительно отсылая оппонента к данному тексту.
Параметры
Некоторые типичные виды параметров заполняются в шаблонах-карточках стандартным способом. При этом устаревшие шаблоны-карточки могут не поддерживать это, в таком случае можно попросить обновить шаблон на странице Википедия:Технические запросы.
Названия даже стандартных параметров могут широко варьироваться — изображение или фотография, описание изображения или подпись, дата создания или создано[7]. Капитализация параметров важна — если параметр называется место рождения, то Место рождения может не работать — в зависимости от указания такого параметра как синонима в шаблоне.
Оригинал названия или имени
Поля для оригинальных названий и имён заполняются при помощи шаблонов серии {{lang-en}}: Шаблон:карточка
| имя = Николай Коперник | оригинал имени = {{lang-la|Nicolaus Copernicus}}
Изображение
Поле изображение заполняется без вики-разметки, а его описание выносится отдельно: Шаблон:карточка
| изображение = Joe Dassin 1970.jpg | описание изображения = Джо Дассен в 1970 году
но не
| изображение = [[Файл:Joe Dassin 1970.jpg|Джо Дассен в 1970 году]]
Шаблон:якорьШаблон:якорьОбратите внимание, что описание изображения должно находиться в том же месте, что и изображение — если изображение задано на Викиданных, то и описание должно быть задано там же. Для этого нужно использовать свойство Ошибка Lua в Модуль:WD на строке 450: attempt to index field 'wikibase' (a nil value). как квалификатор — то есть непосредственно под изображением, а не отдельно. Если описание разместить в статье, то после смены изображения на Викиданных оно может перестать соответствовать изображению.
В большинстве случаев не имеет смысла указывать ширину изображения явно — для фотографий она подгонится под ширину карточки в стационарной версии и немного уже — в мобильной, а для логотипов будет поменьше[8]. Если же возникла необходимость, её можно указать следующим способом:
| ширина = 200px
При этом указание в Шаблон:iw не работает, требуется указывать ширину в пикселях. Можно также опустить px, указав только число, или ввести по-русски: 200пкс.
Указание дат
Даты рождения и смерти заполняются в формате дд.мм.гггг
:
Шаблон:карточка
| дата рождения = 22.04.1724 | дата смерти = 12.02.1804
При заполнении в таком формате автоматически считается текущий возраст или возраст на момент смерти[9].
Некоторые иные даты так же указываются в таком формате, в то же самое время другие указываются как [[дд месяца]] [[гггг]]
.
Перечисление маркированным списком
Некоторые поля заполняют не через запятую, а в столбик, перенося строки — например, главные роли в шаблоне {{Фильм}}. Для этого можно использовать маркированные списки, но при этом маркеры обычно отображаться не будут[10].
| В главных ролях = * [[Рэдклифф, Дэниел|Дэниел Рэдклифф]] * [[Уотсон, Эмма|Эмма Уотсон]] * [[Гринт, Руперт|Руперт Гринт]]
Использование тега <br>
для задания переноса строки — устаревший способ, при котором код менее читаем, поэтому его не рекомендуется использовать.
Медали или награды
Поле медали или награды можно заполнять при помощи шаблона {{ряд-л}}, например: Шаблон:карточка
| медали = {{ряд-л | {{Кавалер Большого креста ордена Почётного легиона}} | {{Кавалер Большого Креста ордена За заслуги перед ФРГ}} | {{Большой крест с лентой Ордена За заслуги перед Итальянской Республикой}} }} {{ряд-л | {{Орден Virtuti Militari 5 степени}} | {{Королевский Викторианский орден|GCVO|почётный}} | {{Орден Серафимов}} }}
Использовать устаревший синтаксис с {{{!}}
, {{!-}}
и {{!}}}
не рекомендуется[11].
Сайт
В поле сайт вводится только гиперссылка, но с префиксом протокола доступа: Шаблон:карточка
| сайт = https://wikimediafoundation.org/
Шаблон {{URL}} для этого не нужен[12].
Категория на Викискладе
Заполнение поля категория на Викискладе напрямую в статье нежелательно, лучше сделать это на Викиданных, в поле Ошибка Lua в Модуль:WD на строке 450: attempt to index field 'wikibase' (a nil value)..
Редактирование шаблонов-карточек
Создание и редактирование шаблонов-карточек требует как технических, так и метапедических навыков и рекомендуется только для опытных участников. В любом случае желательно предварительно проверять свои правки путём тестирования на подстранице-песочнице. Полезно использовать скрипт для оформления кода.
Некоторые примеры шаблонов-карточек — {{Персона}}[13], {{Художник}}, {{Компания}}, {{Язык}}, {{Единица измерения}} и {{Структура данных}}.
Создание шаблонов
Основное, что нужно знать перед созданием шаблонов-карточек — большинство необходимых шаблонов-карточек уже создано. Если вы не можете найти подходящий, попробуйте спросить на форуме вопросов. Возможно, подходящий шаблон-карточка уже существует или вместо его создания следует обобщить и дополнить другой шаблон-карточку.
Тем не менее, если вы опытный участник Википедии и абсолютно уверены в необходимости создать шаблон-карточку, вы можете сделать это с использованием меташаблона {{Карточка}} — техническая инструкция содержится на соответствующей странице. Не следует использовать таблицы или меташаблоны вида {{Что-то там/строка}}.
Полезно поискать подходящий шаблон-карточку в английской, французской или иной крупной Википедии, перейдя по интервикам, и взять за образец его параметры. Но лучше не копировать его код и оформление — нормы последних в разных разделах могут весьма отличаться.
Запрещено создавать форки — шаблоны, повторяющие уже существующую функциональность, но с некоторыми дополнительными особенностями вроде автонумерации или иного оформления, такие случаи подпадают под критерий быстрого удаления О8[14].
Иногда можно создать обёртку шаблона-карточки, но практика спорна и, по мнению некоторых участников, напрасно усложняет техподдержку шаблонов. Тем не менее, полезно делать импортёры карточек для переноса карточек из английского или другого подходящего раздела; в отличие от обычных шаблонов-карточек и их обёрток, импортёры используются с подстановкой.
Функциональность
Желательно ограничивать число параметров разумным количеством, не превращая карточки в таблицы технических характеристик и маловажных деталей;
- и напротив, желательно сделать достаточно общие параметры, чтобы можно было использовать шаблон-карточку в широком кругу статей, и при необходимости задать различные заготовки для копирования для разных типов объектов;
- необходимость прятать часть данных в скрываемые блоки — признак того, что карточка перегружена (исключение — обеспечение доступности путём дублирования редких символов картинкой, как в {{Звук}}); кроме того, скрываемые блоки не работают в мобильной версии.
Не следует использовать технические трюки, усложняющие код и не дающие заметной пользы — благодаря им накапливается технический долг;
- пример такого нежелательного трюка — автовикификация, то есть оборачивание параметра в квадратные скобки в самом шаблоне, а не при его вызове:
| текст1 = [[{{{параметр|}}}]]
сокращающая заполнение на четыре символа в простых случаях, но принуждающая писать эзотерический код вроде
| параметр = Кошечкино (значения){{!}}Кошечкино{{ъъ}}, {{хх}}Собачкино (значения){{!}}Собачкино
в более сложных, например при перечислении нескольких значений. Вариант с предварительной проверкой на наличие статьи, вроде
| текст1 = {{#ifexist: {{{параметр|}}} | [[{{{параметр}}}]] | {{{параметр|}}} }}
тоже плох — поведение шаблона-карточки будет отличаться в зависимости от того, введено в параметр одно значение или же несколько, разделённых запятой, что неинтуитивно.
Не следует задавать значением по умолчанию значение неизвестно: например, появление «автор: неизвестно» в статье о произведении, автор которого не указан в карточке, но известен человечеству, некорректно;
- также не следует делать обязательных параметров, кроме тех, которые действительно необходимы; так, хотя оригинал имени можно заполнить у любого китайского императора, карточка, у которой этот параметр незаполнен, не должна показывать читателям что-то вроде
{{{оригинал имени}}}
— используйте взамен отслеживающие категории.
Нежелательно включение единиц измерения в параметры: использование
| длина, м = 5
вместо
| длина = 5 м
только усложняет ситуацию, когда нужно указать сноску или несколько значений для разных контекстов в одном поле.
Регулярно меняющиеся данные вроде номера версии программы, рейтинга сайта или числа просмотров желательно хранить на Викиданных, поскольку там они обновляются также участниками из других разделов и потому свежее; чтобы не знающие этого участники не переопределяли данные локально, вызывая их будущее устаревание, можно отключить параметр в карточке, например
| метка1 = Последняя версия | викиданные1 = P348
Не экономьте на длине параметров — если в карточке дифференциального уравнения нужно указывать область определения, называйте поле именно так, а не просто область, даже если других областей в шаблоне-карточке не предвидится.
Желательно согласовать название параметров с другими шаблонами-карточками.
Детали реализации
Викиданные
Подключите подходящие свойства Викиданных. В русской Википедии принята широкая интеграция с Викиданными, при которой подключается большинство свойств, которые возможно использовать в карточках[15] — хотя, например, некоторые свойства вроде Ошибка Lua в Модуль:WD на строке 450: attempt to index field 'wikibase' (a nil value). и Ошибка Lua в Модуль:WD на строке 450: attempt to index field 'wikibase' (a nil value). обычно не применяются из-за повышенного риска ориссности, а некоторые другие свойства не используются по техническим причинам[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, они уже подогнаны для разных свойств Викиданных, см. #Параметры выше. Добавлять размер изображения в стандартную заготовку для копирования не рекомендуется, поскольку в статьях его обычно нет нужды использовать, а при добавлении его будут указывать повсеместно.
Помимо свойств Ошибка Lua в Модуль:WD на строке 450: attempt to index field 'wikibase' (a nil value). и Ошибка Lua в Модуль:WD на строке 450: attempt to index field 'wikibase' (a nil value). есть другие медиа-свойства Викиданных. Если нет подходящего свойства Викиданных, можно использовать шаблон {{Карточка/изображение}}[21].
Обратите внимание, что при использовании шаблона {{Wikidata}} внутри функции парсера #if сноски ошибочно дублируются. Для исправления нужно использовать Шаблон:para или шаблон {{If-wikidata}}):
{{#if: {{wikidata|P123|{{{параметр|}}}|plain=true}} | если есть | если нет }}
{{if-wikidata|P123|{{{параметр|}}}|если есть|если нет}}
При этом plain-режим не поддерживает квалификаторы, поэтому при их применении нужно использовать Шаблон:para:
{{#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}}}} }}
Меташаблоны
При необходимости используйте меташаблоны:
- для добавления различных стандартизированных блоков используйте подстраницы шаблона Карточка; например, {{Карточка/название}} вверху и {{Карточка/Викисклад}} внизу карточки соответственно;
- если требуется отображать метки в разном роде — родилась или родился — в зависимости от Ошибка Lua в Модуль:WD на строке 450: attempt to index field 'wikibase' (a nil value)., используйте {{Wikidata gender switch}};
- если требуется отображать метки в разном числе — параметр или параметры — в зависимости от того, заполнено ли одно значение или несколько, используйте {{Wikidata number switch}};
- если нужно перечислить несколько параметров через запятую или перенос строки, но некоторые из них могут отсутствовать, используйте {{comma separated entries}} или {{br separated entries}} соответственно;
Документация
Для карточек следует создавать документацию, при этом не inline-овую (через {{doc-inline}}), а вынесенную на отдельную страницу (через {{doc}}).
Желательно заполнить TemplateData — это позволяет редактировать карточку в визуальном редакторе и упрощает её документирование путём использования шаблонов {{Заготовка шаблона}} и {{Пример шаблона}}.
Нужно добавить в шаблон подходящие подкатегории категории Шаблоны-карточки — как тематические, вроде Шаблоны-карточки:Математика и Шаблоны-карточки:Спорт, так и типовые, вроде Шаблоны-карточки:Организации и Шаблоны-карточки:События.
Указать отслеживающие категории можно в отдельном разделе «Отслеживающие категории» с использованием шаблона {{Категория с размером}}.
Если шаблон-карточка в значительной степени использует модуль Lua, то следует проставить {{onLua}}. Для точечных использований вроде вызовов строковых функций из модуля String этого делать не стоит, даже с параметром Шаблон:para.
Оформление
Параметры обычно именуются на русском языке и в формате оригинал имени (не Оригинал имени, оригинал_имени, ОригИм и т. д.);
- большинство шаблонов-карточек именуются без слова «карточка», в отличие от других разделов, где обычно добавляется слово «infobox»[23].
Размер шрифта в карточках уже уменьшен по сравнению с размером его в статье, поэтому не следует его дополнительно уменьшать, см. соответствующее правило;
- в целом в ручной регулировке шрифтов при правильной разметке обычно нет необходимости — так, в поле вверху автоматически отображается размер 125 %.
Тип объекта можно указать над заголовком, в поле вверху0, но в большинстве карточек в этом нет необходимости и это не делается.
Нужно проверять работу любого задаваемого вручную оформления в нестандартных скинах — обязательно в MinervaNeue, использующемся в мобильной версии[24], но лучше и в MonoBook, которые ранее был основным скином и всё ещё широко используется зарегистрированными участниками. См. ссылки в шаблоне Тесты шаблона.
Цвета
Вверху | |
---|---|
Шаблон:lang-en | |
Первый заголовок | |
Первая метка | первый текст |
Вторая метка | второй текст |
Третья метка | третий текст |
Шаблон:карточка/Викисклад |
По умолчанию у карточек заголовки и иные блоки имеют голубоватый оттенок, использующий цвета, основанные на стандартном оформлении навигационных таблиц (синяя схема). Используемая палитра близка к акцентным цветам из руководства по стилю от Фонда Викимедиа. Для её использования не нужно заполнять никакие дополнительные параметры.
Как примеры см. шаблоны-карточки {{Компания}} и {{Автомобиль}}.
Если в карточке нет поля для изображений и нет поля «заголовок1», или если присутствует поле «вверху3», то для выделения поля «вверху2» можно добавить
| класс_вверху2 = infobox-header
или
| класс_вверху2 = infobox-subheader
в случае, если вам нужно два заголовка разного уровня[25].
В противном случае этого делать не рекомендуется, поскольку пространство между «вверху» и изображением или полем «заголовок1» достаточно выделяет поле «вверху2».
Вверху | |
---|---|
Шаблон:lang-en | |
Первый заголовок | |
Первая метка | первый текст |
Вторая метка | второй текст |
Третья метка | третий текст |
Шаблон:карточка/Викисклад |
Серая схема — одноцветная схема оформления, использующая цвет #eaecf0
, он же Base80 из руководства по стилю от Фонда Викимедиа. Это устаревшая схема оформления, сохраняющаяся в ряде шаблонов.
Эта схема задаётся так:
| цвет = Base
при этом обязательно должен быть заполнен параметр «имя».
Дополнительных цветов для поля «вверху2» и заголовков второго уровня нет, в отличие от синей схемы.
Как примеры см. шаблон-карточку {{Учёный}}.
Так же могут использоваться другие схемы, одобренные для использования тематическими проектами. Для каждой такой схемы должна быть создана подстраница шаблона {{Цвет}}.
Прочие стили
Если поле «внизу» содержит один из шаблонов категории Шаблоны:Подстраницы шаблона Карточка, ссылку на сайт или примечание, то обычно оно имеет цветной фон; если же там содержится карта, то фон обычно прозрачен.
Использование цветов для меток не рекомендуется. Если они всё же используются, они должны быть бледнее цвета заголовка, а также нужно увеличить паддинги:
| стиль_меток = background:{{Цвет|Accent90}}; padding-left:0.4em; padding-right:0.4em;
Хотя использование скрываемых блоков в общем случае не рекомендуется, иногда они нужны — например, для обеспечения доступности путём дублирования редких символов картинкой, как в шаблоне {{Звук}}. В таком случае можно оформить скрываемый блок так, чтобы его заголовок выглядел как подзаголовки в самой карточке. Это делается при помощи шаблона {{Начало скрытого блока}} c такими параметрами:
| текст1 = {{Начало скрытого блока | заголовок = Заголовок | выравнивание_текста = center | стиль_тела = padding:0; font-size:100%; | стиль_заголовка = padding:0; background:{{Цвет|Accent80}}; | рамка = none }} Скрываемое содержимое {{Конец скрытого блока}} | стиль_текста1 = padding:0;
Маркированные подпараметры можно оформить с помощью {{Карточка/блок с маркерами}}. При этом не рекомендуется ими злоупотреблять — заголовки часто предпочтительнее.
Рекомендуется использовать стандартную ширину карточки — 23em (явно указывать не требуется), но при необходимость можно использовать 27em или 19em.
Использование иных стилей не рекомендуется.
Ссылки на статьи в других языковых разделах
При использовании в карточках ссылок на другие языковые разделы следует использовать шаблон {{iw}}. Использование шаблонов {{нп1}}, {{нп2}}, {{нп3}} и {{нп4}} неконсистентно со ссылками, генерируемыми при вызове значений из Викиданных. Также крайне не рекомендуется использовать прямые вики-ссылки вида [[:en:article|статья]]
.
См. также
Справочные страницы
- Проект:Инкубатор/Справочники и пособия/Шаблоны-карточки
- Проект:Технические работы/Оформление шаблонов
- en:Wikipedia:Manual of Style/Infoboxes
- en:Help:Infobox
- Википедия:Шаблоны
- Википедия:Навигационные шаблоны
Конкретные карточки
- Категория:Шаблоны-карточки
- Проект:Рутинная работа/Все шаблоны-карточки (категория)
- Проект:Рутинная работа/Шаблоны-карточки по числу включений
- Проект:Рутинная работа/Шаблоны для перевода на карточку (категория)
- Проект:Рутинная работа/Шаблоны — возможные кандидаты на объединение
Прочие полезные страницы
Примечания
Шаблон:Геокарточки Шаблон:Антропогенные геокарточки
- ↑ Терминология чётко не зафиксирована и слова «карточка» и «шаблон-карточка» могут использоваться взаимозаменяемо.
- ↑ В любую статью можно добавить универсальную карточку, но в большинстве случае это совершенно не нужно делать.
- ↑ Что-то вроде Шаблон:para для отключения взятия информации с Викиданных не работает.
- ↑ В русском разделе у большинства шаблонов-карточек подключено несколько свойств, а в других разделах, в частности в английском, это может быть редкостью.
- ↑ Существует карточка, которая вообще не имеет параметров и всё берёт из Викиданных, {{универсальная карточка}}, однако её следует использовать только тогда, когда нет более подходящей карточки, см. подробности в её документации.
- ↑ Это продолжение, а начало не имеет отношения к шаблонам-карточкам.
- ↑ См. некоторые идеи по стандартизации во внутрипроектном соглашении Проект:Технические работы/Оформление шаблонов
- ↑ При условии, что параметр подключен к подходящему полю Викиданных — например, Ошибка Lua в Модуль:WD на строке 450: attempt to index field 'wikibase' (a nil value). для логотипов.
- ↑ При условии, что параметры используют шаблоны {{wikidata/p569}} и {{wikidata/p570}}.
- ↑ Хотя шаблон может быть настроен так, чтобы маркеры отображались — заданием Шаблон:para
- ↑ Этот способ подлежит ботозамене согласно итогу на Википедия:Форум/Архив/Предложения/2017/12#Переоформление наград с помощью шаблона «Ряд».
- ↑ При условии, что параметр подключен к полю Ошибка Lua в Модуль:WD на строке 450: attempt to index field 'wikibase' (a nil value). Викиданных.
- ↑ Шаблон-карточка {{Персона}} по многим параметрам является де-факто стандартом для шаблонов-карточек.
- ↑ Термин «форк» также может использоваться для статей, являющихся ответвлениями мнений, но там он используется в другом контексте.
- ↑ Во французской Википедии и некоторых более мелких разделах также берётся информация с Викиданных, но в очень разных масштабах. В английской Википедии Викиданные практически не используются в карточках, а там, где используется, требуется обязательное указание источника на Викиданных.
- ↑ Например, нет возможности импортировать Ошибка Lua в Модуль:WD на строке 450: attempt to index field 'wikibase' (a nil value). вместе с квалификаторами в виде, нужном для шаблона {{Государственная должность}}, и нет корректной поддержки типа math.
- ↑ Кроме случая, когда в {{Карточка}} задан параметр from, см. чуть ниже
- ↑ Запросить добавление можно на странице Википедия:Технические запросы
- ↑ Использование #ifeq необходимо для того, чтобы работало отключение взятия информации через минус, а иначе внутренний шаблон {{Wikidata}} оборачивает минус в служебные тэги, а внешний перестаёт воспринимать его как минус.
- ↑ Возможно, следует внедрить поддержку перечисления свойств через точку с запятой в параметрах викиданныеN шаблона {{Карточка}}
- ↑ Требуется объединение его и модуля InfoboxImage в единый механизм — возможно, так с объединением с функцией Wikidata.formatCommonsMedia. См. также: Модуль:Wikidata/media как возможное место для объединения
- ↑ Возможно, также можно использовать модуль AdjustSortKey, но лучше сначала обернуть его в шаблон.
- ↑ Так, на ноябрь 2019 года без слова «карточка» именуются 93 % шаблонов-карточек, см. выдачу PetScan.
- ↑ Но скин MinervaNeue может использоваться и без мобильной версии, поэтому желательно проверить наличие ru.m.wikipedia.org вместо ru.wikipedia.org в адресной строке.
- ↑ При использовании заголовков второго уровня желательно явно указать Шаблон:para в шаблоне {{Карточка}} на случай, если в будущем значение по умолчанию будет изменено с нет на да.