Шаблон:Wikidata

Документация

[просмотр | править | история | обновить]

Внимание! Это один из самых используемых шаблонов.

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

Этот шаблон реализован на основе Lua с использованием функции formatProperty() из модуля Wikidata.

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

{{Wikidata|1=Свойство|2=Локальное значение}}

{{wikidata|p559|{{{конечные|{{{Конечные|}}}}}}|separator=<br>|conjunction=<br>}}

1: Идентификатор свойства на Викиданных в формате pXXXX, список доступных свойств: Special:AllPages:Properties.

2: Значение, перекрывающее информацию с Викиданных, обычно это параметр шаблона в форме {{{parameter|}}}.

Если это значение пусто, то только тогда оно будет затребовано с Викиданных.

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

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

Если параметры для форматирования одинаковы при всех вызовах шаблона для одного свойства, то лучше перенести иx в Модуль:Wikidata/config и вызывать шаблон без лишних параметров.

Параметры форматирования передаются обрабатывающему соответствующее свойство модулю (например, Модуль:Wikidata/Places), поэтому, если он отличается от стандартного Модуль:Wikidata, то некоторые из них могут не поддерживаться, хотя вполне иметь смысл.

TemplateData

Техническое замечание: шаблон поддерживает параметры трёх видов:

общие параметры — например from, с помощью которого можно сменить ID элемента, из которого нужно получить данные, работает для любого свойства;
параметры, работающие для свойств определённых типов данных — например, caption предназначен для типа данных «медиафайл с Викисклада» (к которому относятся, например, свойства изображение (P18) и изображение флага (P41)) и задаёт описание изображения;
параметры, работающие для отдельных свойств — например, icon_size предназначен для свойства категория на Викискладе (P373) и меняет размер иконки рядом с ссылкой на Викисклад; при этом свойство категория на Викискладе (P373) имеет тип «строка», но для других свойств типа «строка» параметр icon_size работать не будет.

В документации ниже перечислены только параметры первых двух видов. Это связано с тем, что шаблон потенциально принимает неограниченное число параметров за счёт задания кастомизированных обработчиков в параметрах …-module/…-function, см. документацию Модуль:Wikidata. Для многих свойств такие обработчики уже включены по умолчанию в Модуль:Wikidata/config и добавляют шаблону новые параметры третьего вида — например, для категория на Викискладе (P373) включен параметр icon_size, который обрабатывается в Модуль:Wikidata/media, а для код IMDb (P345) включен параметр prefix, который обрабатывается в Модуль:Wikidata/link. Однако перечисление всех параметров третьего вида сделало бы документацию слишком громоздкой.

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

[Править данные шаблона]
Параметры шаблона
Шаблон использует строчное форматирование параметров.
Параметр	Описание	Тип	Статус
Свойство	`1`	Идентификатор свойства на Викиданных, может содержать селекторы (см. Модуль:WikidataSelectors) Пример p1234	Строковый (без форматирования)	обязательный
Локальное значение	`2`	Значение, перекрывающее информацию с Викиданных, обычно это параметр шаблона в форме {{{параметр\|}}}. Если значение равно «-», то будет возвращена пустая строка	Строковый (без форматирования)	необязательный
Элемент Викиданных	`from`	ID элемента, из которого нужно получить данные. По умолчанию берутся из элемента, связанного с текущей страницей Пример Q5	Однострочный	необязательный
Простое значение	`plain`	Если не 0, не пустая строка и не false, то значение возвращается в виде простой строки со значением без вики-форматирования По умолчанию false	Логическое значение	необязательный
Префикс	`before`	Префикс перед первым элементом списка, отображается только если список непуст Пример <ul><li>	Строковый (без форматирования)	необязательный
Разделитель	`separator`	Для создания текста со списком оформленных заявлений из таблицы Пример ,<br>	Строковый (без форматирования)	необязательный
Последний разделитель	`conjunction`	Разделитель для последнего элемента списка По умолчанию и Пример или	Строковый (без форматирования)	необязательный
Постфикс	`after`	Постфикс после последнего элемента списка, отображается только если список непуст Пример </li></ul>	Строковый (без форматирования)	необязательный
Значение неизвестно	`somevalue`	Текст, который выводится, если в Викиданных выбрано «значение неизвестно» По умолчанию ''неизвестно''	Однострочный	необязательный
Значение отсутствует	`novalue`	Текст, который выводится, если в Викиданных выбрано «значение отсутствует»	Однострочный	необязательный
Nocat	`nocat`	Отключить автоматическое добавление категории (работа зависит от поддержки конкретным подмодулем) По умолчанию false Пример true	Логическое значение	необязательный
Максимальное число значений	`limit`	Наибольшее число значений, которое нужно выдать (- для бесконечности) По умолчанию - Пример 1	Число	необязательный
Квалификатор	`qualifier`	Квалификатор, который нужно добавить в скобках после основного значения Пример P155	Однострочный	необязательный
Свойство для категории	`category`	Свойство, из которого брать автоматически добавляемую категорию Пример P910	Однострочный	необязательный
Сноски с источниками	`references`	Отображать ли сноски с источниками По умолчанию true Пример false	Логическое значение	необязательный
Формат	`format`	(для свойств типа «элемент Викиданных») TODO: Описать смысл	Неизвестно	необязательный
Текст	`text`	(для свойств типа «элемент Викиданных» и «URL») Замещающий текст, отображаемый вместо элемента Викиданных (ссылка на сам элемент при этом сохраняется) Пример ссылка	Строковый (без форматирования)	необязательный
Максимальная длина	`length`	(для свойств типа «URL») Максимальная показываемая длина URL'а По умолчанию max(18, 25 - длина языковых ссылок) Пример 10	Число	необязательный
Шаблон моноязычного текста	`monolingualLangTemplate`	(для свойств типа «моноязычный текст») шаблон, в который оборачивается моноязычный текст Пример lang или ref	Однострочный	необязательный
Размер медиафайла	`size`	(для свойств типа «медиафайл с Викисклада») Ширина и высота изображения или видео Пример 250x350px	Однострочный	необязательный
Подпись	`caption`	(для свойств типа «медиафайл с Викисклада») Описание изображения Пример Фотография на балу, 2005 год	Однострочный	необязательный
Alt-текст медиафайла	`alt`	(для свойств типа «медиафайл с Викисклада») Замена изображения текстовым описанием для слабовидящих или людей с текстовым браузером Пример Мужчина в чёрном костюме и шляпе	Однострочный	необязательный
Рамка изображения	`border`	(для свойств типа «медиафайл с Викисклада») Нужно ли показывать тонкую серую рамку вокруг изображения По умолчанию false Пример true	Логическое значение	необязательный
Добавить момент времени	`appendTimestamp`	(для свойств типа «медиафайл с Викисклада») Добавить момент времени По умолчанию false Пример true	Логическое значение	необязательный
Положение координат	`display`	(для свойств типа «глобальные координаты») Где отображаются координаты: вверху страницы и/или на месте вставки По умолчанию title Пример inline,title Автозначение `inline,title`	Однострочный	необязательный
Nocoord	`nocoord`	(для свойств типа «глобальные координаты») Не выводить координаты По умолчанию false Пример true	Логическое значение	необязательный
Тип карты	`type`	(для свойств типа «глобальные координаты») Тип карты, передаваемый шаблону coord Пример city	Однострочный	необязательный
Часть значения	`subvalue`	(для свойств типа «глобальные координаты») Вернуть только часть значения и в сыром виде Пример latitude или longitude	Однострочный	необязательный
Небесное тело	`globe`	(для свойств типа «глобальные координаты») Небесное тело, на котором находится объект По умолчанию earth Пример moon	Однострочный	необязательный
Строка форматирования	`formatter`	(для свойств типа «внешний идентификатор») Строка для форматирования ссылки из идентификатора Пример https://example.com/id=$1	Строковый (без форматирования)	необязательный
Заголовок ссылки	`title`	(для свойств типа «внешний идентификатор») Заголовок ссылки с внешним идентификатором (работает, только если задана строка форматирования) Пример Страница в базе такой-то	Строковый (без форматирования)	необязательный
Префикс категории	`categoryPrefix`	(для свойств типа «момент времени») Префикс автоматически добавляемой категории Пример Родившиеся	Строковый (без форматирования)	необязательный
Единица измерения	`unit`	(для свойств типа «количество») Единица измерения, добавляемая после величины Пример км	Однострочный	необязательный
Преобразовать в СИ	`siConversion`	(для свойств типа «количество») Преобразовывать ли значение в Международную систему единиц По умолчанию false Пример true	Логическое значение	необязательный

Другие шаблоны для вывода информации из Викиданных

См. также

{{WD}} — для создания ссылок на элементы и свойства Викиданных