Шаблон: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 предназначен для типа данных «медиафайл с Викисклада» (к которому относятся, например, свойства и ) и задаёт описание изображения;
• параметры, работающие для отдельных свойств — например, icon_size предназначен для свойства и меняет размер иконки рядом с ссылкой на Викисклад; при этом свойство имеет тип «строка», но для других свойств типа «строка» параметр icon_size работать не будет.

В документации ниже перечислены только параметры первых двух видов. Это связано с тем, что шаблон потенциально принимает неограниченное число параметров за счёт задания кастомизированных обработчиков в параметрах …-module/…-function, см. документацию Модуль:Wikidata. Для многих свойств такие обработчики уже включены по умолчанию в Модуль:Wikidata/config и добавляют шаблону новые параметры третьего вида — например, для включен параметр icon_size, который обрабатывается в Модуль:Wikidata/media, а для включен параметр 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	Логическое значение	необязательный

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

• Wikidata/doc

См. также

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

Во избежание поломок страниц, использующих этот шаблон, экспериментируйте в песочнице (создать | зеркало) или своём личном пространстве.
Пожалуйста, добавляйте категории на подстраницу /doc. Подстраницы этого шаблона.