Этот шаблон предназначен для извлечения данных из Викиданных со ссылкой на связанную статью Википедии или без нее, а также со многими другими функциями.
Общая структура вызова этого шаблона выглядит следующим образом. Обратите внимание, что базовая структура состоит из позиционных команд, флагов и аргументов, которые все имеют фиксированную позицию.
{{wikidata|command1|flag1a|flag1b|flag1c|command2|flag2a|flag2b|flag2c|flag0a|flag0b|flag0c|arg1|arg2|arg3}}
Используйте разные команды для получения разных видов значений из Wikidata. Должна быть указана как минимум одна команда, и несколько команд могут быть объединены в один вызов, как показано выше (в любом порядке, возможно также более двух), но это применимо только к командам из класса claim; вызовы, содержащие команду из общего класса, не могут содержать никаких других команд. За каждой командой может следовать любое количество флагов команд, которые являются необязательными и могут использоваться для настройки вывода, генерируемого этой командой.
За командами и их флагами может следовать любое количество флагов конфигурации, которые также являются необязательными и влияют на выбор данных и поведение шаблона в целом. Вызов закрывается позиционными аргументами, которые могут потребоваться в зависимости от заданной команды(команд). Существуют также некоторые именованные аргументы (например, пары имя-значение), а также набор именованных флагов для расширенного использования, которые можно использовать для изменения способа объединения извлеченных значений в вывод.
Этот шаблон был разработан для обеспечения основных потребностей в извлечении данных из Wikidata, но многого можно достичь с помощью различных комбинаций вызовов. Для удобства такие комбинации можно обернуть в новые шаблоны, которые обслуживают конкретную потребность. См. также раздел о распространенных вариантах использования ниже для некоторых примеров полезных «строительных блоков». Аналогично, функциональность этого шаблона можно расширить, создав шаблоны-обертки, которые используют команду, main
предоставляемую Module :Wd , которая используется этим шаблоном (точно так же, как это делает {{ WikidataOI }} ).
Ниже приведен список общих случаев использования. В будущем могут быть реализованы команды быстрого доступа, эквивалентные этим вызовам для удобства.
Команды ( command1
, command2
, ...) определяют, какие значения возвращаются. Один вызов может содержать только команды из одного класса.
Команды класса утверждений можно комбинировать, что означает, что одновременно можно подавать несколько команд разных типов из этого класса (см. выше порядок использования).
Объедините несколько команд в один вызов этого шаблона вместо того, чтобы делать несколько вызовов этого шаблона с одной командой каждый, чтобы быть уверенным, что все возвращаемые фрагменты информации принадлежат друг другу (см. также примеры ниже).
Команды общего класса не могут быть объединены.
Доступны следующие (необязательные) флаги, которые можно использовать для изменения поведения этого шаблона. Они должны быть указаны после (первой) команды и перед позиционными аргументами . Для удобства пустые флаги (т.е. ||
) разрешены и будут просто игнорироваться.
Эти флаги ( flag1*
, flag2*
, ...) применяются к команде, которая им непосредственно предшествует.
Эти флаги ( flag0*
) являются общими флагами конфигурации и могут быть указаны в любом месте после первой команды (но до позиционных аргументов ).
Аргументы определяют источники, из которых извлекаются все возвращаемые значения.
В следующей таблице показаны доступные позиционные аргументы ( arg*
) в их фиксированном порядке. Для каждой команды помечен применимый набор аргументов. Если задано несколько команд, то применимый набор — это объединение отдельных наборов. Например, если были заданы команды properties
и , то по крайней мере оба аргумента и должны быть заданы.qualifiers
property_id
qualifier_id
Можно задать более одной команды qualifier
/ . Порядок, в котором даны эти команды с их флагами, соответствует порядку, в котором даны соответствующие аргументы.qualifiers
qualifier_id
Ниже следует описание всех позиционных аргументов.
Ниже следует описание всех именованных аргументов, которые являются парами имя-значение (т.е. |name=value
). Они все необязательны и могут быть указаны в любом месте вызова.
Псевдонимы свойств — это другие названия P-идентификаторов, которые можно использовать вместо них. В настоящее время доступны следующие псевдонимы свойств (чувствительные к регистру ):
Когда используется команда reference
или references
и встречается ссылка (в Wikidata), модуль проверяет, содержит ли ссылка импортированное из проекта Wikimedia (P143), выведенное из (P3452) или свойство URL импорта Wikimedia (P4656). В случае, если присутствует одно из этих свойств, вся ссылка игнорируется (т. е. она рассматривается так, как будто ее нет).
В противном случае модуль пытается отобразить ссылку, используя шаблон {{ Cite web }} . Ссылка должна иметь свойство URL ссылки (P854). В таблице ниже показано сопоставление свойств Wikidata с параметрами Cite web.
Следующие свойства игнорируются: изображение (P18), тип ссылки (P3865).
Если в ссылке отсутствует свойство URL-адреса ссылки (P854), но свойство типа данных «Внешний идентификатор» присутствует как в ссылке, так и в свойстве Wikidata (P1687) элемента, указанного в (P248), URL-адрес генерируется из его содержимого и используется таким же образом, как URL-адрес, указанный в URL-адресе ссылки (P854).
Если свойство URL ссылки (P854) отсутствует или ссылка имеет неизвестные свойства, модуль пытается отобразить ее с помощью шаблона {{ Cite Q }} . Указанное в свойстве (P248) является обязательным. В таблице ниже показано сопоставление свойств с параметрами Cite Q.
Свойства, перечисленные в первой таблице (в этом разделе), также игнорируются при использовании Cite Q.
Ссылка может быть отображена с помощью Cite Q только в том случае, если ссылка имеет указанное в (P248) свойство и имеет только свойства, перечисленные в таблице выше. Если ни Cite web, ни Cite Q не могут быть использованы для отображения ссылки, возвращается следующее сообщение об ошибке с пояснением.
Чтобы исправить эту ошибку, проверьте, имеет ли ссылка требуемые свойства и нет ли неизвестных свойств, как описано выше. Справочная страница Wikidata по ссылкам также может быть полезна при поиске утверждений.
Макет вывода (комбинации) команд, которые имеют как форму единственного, так и множественного числа (например, property
/ properties
), можно настроить с помощью ряда именованных флагов, которые являются парами имя-значение (например, |flag=value
), которые можно задать в любом месте вызова. В таблице ниже показаны доступные именованные флаги.
Чтобы вставить пробел в начале или конце value
, используйте подчеркивание _
. Чтобы получить буквальное подчеркивание, экранируйте его, поместив обратную косую черту \
прямо перед ним (т.е. \_
); то же самое относится к буквальной обратной косой черте (т.е. \\
). Чтобы получить буквальную вертикальную черту |
, используйте или .{{!}}
|
Этот шаблон извлекает данные из централизованной базы знаний Wikidata. Чтобы редактировать данные, нажмите на «Элемент Wikidata» на левой боковой панели.