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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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