Шаблон:Wikidata/doc: различия между версиями

Материал из ChronoWiki
Перейти к навигацииПерейти к поиску
(орфография)
м (1 версия импортирована)
 
(нет различий)

Текущая версия на 00:22, 30 мая 2021

Шаблон:Fmbox

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

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

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

1: Идентификатор свойства на Викиданных в формате pXXXX, список доступных свойств: Special:AllPages:Properties.
2: Значение, перекрывающее информацию с Викиданных, обычно это параметр шаблона в форме {{{parameter|}}}.
Если это значение пусто, то только тогда оно будет затребовано с Викиданных.
Рекомендуется не задавать в этом параметре значение, если оно равно значению на Викиданных. В таком случае, при его изменении в базе данных, оно может быть использовано сразу.
Если в параметре содержится значение -, то значение из Викиданных не будет показываться.

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

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

TemplateData

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

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

Параметры шаблона

Шаблон использует строчное форматирование параметров.

ПараметрОписаниеТипСтатус
Свойство1

Идентификатор свойства на Викиданных, может содержать селекторы (см. Модуль:WikidataSelectors)

Пример
p1234
Текст (произвольной длины)обязательный
Локальное значение2

Значение, перекрывающее информацию с Викиданных, обычно это параметр шаблона в форме {{{параметр|}}}. Если значение равно «-», то будет возвращена пустая строка

Текст (произвольной длины)необязательный
Элемент Викиданныхfrom

ID элемента, из которого нужно получить данные. По умолчанию берутся из элемента, связанного с текущей страницей

Пример
Q5
Строка (короткая)необязательный
Простое значениеplain

Если не 0, не пустая строка и не false, то значение возвращается в виде простой строки со значением без вики-форматирования

По умолчанию
false
Логическое значениенеобязательный
Разделительseparator

Для создания текста со списком оформленных заявлений из таблицы

Пример
,<br>
Текст (произвольной длины)необязательный
Последний разделительconjunction

Разделитель для последнего элемента списка

По умолчанию
и
Пример
или
Текст (произвольной длины)необязательный
Значение неизвестноsomevalue

Текст, который выводится, если в Викиданных выбрано «значение неизвестно»

По умолчанию
''неизвестно''
Строка (короткая)необязательный
Значение отсутствуетnovalue

Текст, который выводится, если в Викиданных выбрано «значение отсутствует»

Строка (короткая)необязательный
Nocatnocat

Отключить автоматическое добавление категории (работа зависит от поддержки конкретным подмодулем)

По умолчанию
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
Строка (короткая)необязательный
Nocoordnocoord

(для свойств типа «глобальные координаты») Не выводить координаты

По умолчанию
false
Пример
true
Логическое значениенеобязательный
Тип картыtype

(для свойств типа «глобальные координаты») Тип карты, передаваемый шаблону coord

Пример
city
Строка (короткая)необязательный
Часть значенияsubvalue

(для свойств типа «глобальные координаты») Вернуть только часть значения и в сыром виде

Пример
latitude или longitude
Строка (короткая)необязательный
Небесное телоglobe

(для свойств типа «глобальные координаты») Небесное тело, на котором находится объект

По умолчанию
earth
Пример
moon
Строка (короткая)необязательный
Строка форматированияformatter

(для свойств типа «внешний идентификатор») Строка для форматирования ссылки из идентификатора

Пример
https://example.com/id=$1
Текст (произвольной длины)необязательный
Заголовок ссылкиtitle

(для свойств типа «внешний идентификатор») Заголовок ссылки с внешним идентификатором (работает, только если задана строка форматирования)

Пример
Страница в базе такой-то
Текст (произвольной длины)необязательный
Префикс категорииcategoryPrefix

(для свойств типа «момент времени») Префикс автоматически добавляемой категории

Пример
Родившиеся
Текст (произвольной длины)необязательный
Единица измеренияunit

(для свойств типа «количество») Единица измерения, добавляемая после величины

Пример
км
Строка (короткая)необязательный
Преобразовать в СИsiConversion

(для свойств типа «количество») Преобразовывать ли значение в Международную систему единиц

По умолчанию
false
Пример
true
Логическое значениенеобязательный

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

См. также

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