Шаблон:Wikidata/doc

Материал из Altermed Wiki
Перейти к навигации Перейти к поиску

{{#invoke:Message box|fmbox}} {{#invoke:Message box|ombox}} {{#invoke:Message box|ombox}}

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

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

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


<templatedata> { "description": "Шаблон, упрощающий работу со свойствами Викиданных, их использование в шаблонах и статьях.", "params": { "1": { "label": "Свойство", "description": "Идентификатор свойства на Викиданных, может содержать селекторы (см. Модуль:WikidataSelectors)", "type": "string", "required": true, "example": "p1234" }, "2": { "label": "Локальное значение", "description": "Значение, перекрывающее информацию с Викиданных, обычно это параметр шаблона в форме . Если значение равно «-», то будет возвращена пустая строка", "type": "string" }, "plain": { "label": "Простое значение", "description": "Если не 0, не пустая строка и не false, то значение возвращается в виде простой строки со значением без вики-форматирования", "type": "boolean", "default": "false" }, "before": { "label": "Префикс", "description": "Префикс перед первым элементом списка, отображается только если список непуст",

"example": "

  • ", "type": "string" }, "separator": { "label": "Разделитель", "description": "Для создания текста со списком оформленных заявлений из таблицы", "example": ",
    ", "type": "string" }, "conjunction": { "label": "Последний разделитель", "description": "Разделитель для последнего элемента списка", "type": "string", "example": "или", "default": "и" }, "after": { "label": "Постфикс", "description": "Постфикс после последнего элемента списка, отображается только если список непуст", "example": "

",

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

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

См. также[править код]

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