Справка:QuickStatements

Инструмент QuickStatements был несколько раз изменен и переписан. По возможности необходимо всегда использовать текущую версию инструмента. Доступны следующие версии QuickStatements:

• QuickStatements версия 2 (V2) переписано или новый интерфейс (текущая версия)
• История версий
  • QuickStatements версия 2 (V2) исходный или старый интерфейс (перестала работать с момента переезда на quickstatements.toolforge.org)
  • QuickStatements версия 1 (V1) (работает но больше не поддерживается)

Синтаксис между версиями может слегка отличаться. Дальнейший текст на этой странице описывает синтаксис текущей версии, но при этом помечены части, которые не поддерживаются в прошлых версиях.

В данном разделе описывается синтаксис, используемый после версии V1 инструмента, которую иногда называют команды V1^[1].

Вы можете указывать утверждения вручную или вводя/вставляя их в текстовое поле. Разделять части утверждений нужно символом TAB или "|"^[2]. Каждая команда должна находиться на новой строке либо можно использовать разделитель "||"^[2].

Совет: вы можете использовать электронные таблицы вроде Microsoft Excel или LibreOffice Calc; при копировании ячеек в буфер обмена и их последующей вставке в текстовое поле символы табуляции TAB добавятся автоматически. Некоторые текстовые редакторы, такие как Notepad++, также позволяют заменить любой символ на TAB (\t).

Каждое утверждение должно состоять из сущности, a свойства и значения свойства. Сущность может быть элементом, свойством, лексемой^[2], формой^[2] или смыслом^[2]. Значение в зависимости от типа данных свойства может быть другим элементом, строкой, временем, координатами или численным значением, или же специальным значением somevalue или novalue (см. Unknown or no values).

Формат каждого блока:

• Элементы Викиданных всегда указываются в формате Qxx. На Викискладе они всегда в формате Mxx. В QuickStatements версии 1 можно было использовать название статьи вместо q-кода, если заполнить значение xxwiki в поле ввода над текстовой областью; в этом случае номер элемента (при его наличии) определялся автоматически.

  Пример: Q4115189 TAB P31 TAB Q1

  Смысл: добавить в элемент Wikidata Sandbox (Q4115189)instance of (P31)Universe (Q1)

• Свойства в формате Pxx.
• Лексемы в формате Lxxx.
• Формы в формате Lxxx-Fyy.
• Значения в формате Lxxx-Syy.
• Строки (включая адреса сайтов, а также числовые значения текстовых полей, например, значения внешних ID свойств) должны находиться в "двойных кавычках". Значения многих утверждений имеют строковый формат, включая внешние идентификаторы (например, VIAF ID (P214)), имена файлов (например, image (P18)) или названия других страниц (например, Commons category (P373)).

  Пример: Q41576278 TAB P373 TAB "Antoni Ignacy Mietelski"

  Смысл: добавить в элемент Antoni Ignacy Mietelski (Q41576278)Commons category (P373)Antoni Ignacy Mietelski

  Внимание! Некоторые символы в строке могут неправильно восприниматься инструментом. Такие символы включают:: "_" (нижнее подчеркивание), " (двойную кавычку), " " (пробел), "=" и, возможно, другие. Добавление адресов сайтов, включающих такие символы, например такого или такого может быть неуспешным. Добавление строк и адресов сайтов с такими символами может быть успешным при работе с инструментом при помощи интерфейса, но неуспешным при работе через URL.

• Моноязычный текст представляет собой код языка, двоеточие и текст в "двойных кавычках", например, en:"Some text"

  Пример: Q1214098 TAB P1476 TAB pl:"Krzyżacy"

  Смысл: добавить в элемент The Knights of the Cross (Q1214098)title (P1476)"Krzyżacy" (Polish)

• Временные значения должны быть в формате, например, +1967-01-17T00:00:00Z/11, где /11 обозначает точность. Точность может быть: 0 - миллиард лет, 1 - сто миллионов лет, ..., 6 - тысячелетие, 7 - век, 8 - декада, 9 - год (по умолчанию), 10 - месяц, 11 - день, 12 - час, 13 - минута, 14 - секунда.

  Пример: Q41576483 TAB P569 TAB +1839-00-00T00:00:00Z/9

  Смысл: добавить в элемент Bronisław Podbielski (Q41576483)date of birth (P569)+1839

  Используйте «-» для дат до нашей эры и задавайте не меньше 4 цифр.

  Set an additional "/J" if you want to set the date in Julian Calendar (see this list to understand where this should be done).

  Если вводить значения через API, требуется использовать символы %09 вместо TAB, %2B вместо +, %3A вместо : и %2F вместо /.

• Координаты надо указывать в формате @LAT/LON при этом LAT и LON должны быть десятичными числами.

  Пример: Q3669835 TAB P625 TAB @43.26193/10.92708

  Смысл: добавить координаты для San Dalmazio (Q3669835)

• Численные значения в формате amount~toleranceUxx^[2], где amount и tolerance – рациональные числа, а Uxx – номер элемента единицы изменения (Qxx). Значения Unit и tolerance являются необязательными. Не оставляйте пробелы в определении численного значения.

  В QuickStatements версии 1 использовался другой синтаксис для численных значений: amount[lower,upper]Uxx, где amount, lower и upper – рациональные числа.

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

  amount, lower and upper must use . as decimal separator, must not use any thousands separator and may be prefixed by "+" or "-".

  10, 10U11573, -10[-12.5,-7.5], 0[-5,5]U11573 are all valid quantities (where U11573 indicates metre (Q11573))

  Quantities with tolerance may be entered as 1.2~0.3 in QuickStatements version 2, which is the same as 1.2[0.9,1.5] in QuickStatements version 1 and means 1.2±0.3. ^[3]

• somevalue for unknown value Help
• novalue for no value Help. Both novalue and somevalue should be used without double quotes around it. Both of those statements do work as part of item creation statements using CREATE and LAST keywords.

Каждый «триплет» утверждений может сопровождаться неограниченных числом «квалификаторных пар» property TAB value.

Пример: Q41577083 TAB P570 TAB +1586-00-00T00:00:00Z/7 TAB P1319 TAB +1586-00-00T00:00:00Z/9

Смысл: добавить к Gian Federigo Bonzagna (Q41577083)date of death (P570)16. centuryearliest date (P1319)+1586

Каждое утверждение может иметь неограниченное количество источников source property TAB value. Источник как свойство аналогичен «обычным» свойствам, но называется в формате Sxx, а не Pxx.

Пример: Q22124656 TAB P21 TAB Q6581097 TAB S143 TAB Q24731821 TAB S813 TAB +2017-10-04T00:00:00Z/11

Смысл: добавить для Gotō Ichijō (Q22124656)sex or gender (P21)male (Q6581097) источник imported from Wikimedia project (P143)Commons Creator page (Q24731821)retrieved (P813)4 October 2017

На заметку:

• Existing statements with an exact match (property and value) will not be added again; however additional references might be added to the statement.
• You can mix qualifiers and references in the same statement. Just use Sxx instead of Pxx when using sources.
• In QuickStatements version 1 each source claim represented an individual reference, i.e. they were not grouped within one reference; it works properly now in QuickStatements version 2.

Как и при добавлении простых текстовых утверждений каждая команда должна состоять из элемента, команды и строки string в двойных кавычках.

• Чтобы добавить элементу метку на определённом языке, используйте «Lxx» вместо свойства (где «xx» — код языка).

  Пример: Q340122 TAB Lpl TAB "Cyprian Kamil Norwid"

  Смысл: добавить метку на польском «Cyprian Kamil Norwid» для Cyprian Norwid (Q340122)

• Чтобы добавить элементу синоним на определённом языке, используйте «Axx» вместо свойства (где «xx» — код языка).

  Пример: Q340122 TAB Aen TAB "Cyprjan Kamil Norwid"

  Смысл: добавить синоним на польском «Cyprjan Kamil Norwid» для Cyprian Norwid (Q340122)

  Совет: Возможно добавлять сразу по несколько синонимов, разделяя их вертикальной линией («|»).

  Пример: Q340122 TAB Aen TAB "Cyprian Kamil Norwid|Cypryan Kamil Norvid"

• Чтобы добавить элементу описание на определённом языке, используйте «Dxx» вместо свойства (где «xx» — код языка).

  Пример: Q340122 TAB Dde TAB "polnischer Dichter"

  Смысл: добавить описание на немецком «polnischer Dichter» для Cyprian Norwid (Q340122)

• Чтобы добавить элементу интервики на определённую страницу проекта Викимедиа, используйте «Sxxx» вместо свойства (где «xxx» — код проекта: например, ruwiki, commonswiki).

  Пример: Q340122 TAB Szhwiki TAB "塞浦路斯·諾爾維特"

  Смысл: добавить интервики на китайскую Википедию (塞浦路斯·諾爾維特) для Cyprian Norwid (Q340122)

Пожалуйста, убедитесь, что не создаёте дубликаты!

Вы можете создать новые элементы, просто добавляя строки, которые содержат одно ключевое слово "CREATE". Для добавления statements для последнего созданного элемента, используйте ключевое слово "LAST" или Q number, and the statement will be added to the last created item.

Пример создания нового элемента, добавления интервики и установки метки:

CREATE

LAST TAB Sfrwiki TAB "Le croissant magnifique!"

LAST TAB Lfr TAB "Le croissant magnifique!"

Смысл: создание нового элемента со ссылкой на французскую Википедию w:fr:Le croissant magnifique! и с меткой французского языка "Le croissant magnifique!"

commonsMedia, globe-coordinate, wikibase-item, wikibase-property, string, monolingualtext, external-id, quantity, time, url, math, geo-shape, musical-notation, tabular-data, wikibase-lexeme, wikibase-form, wikibase-sense.

Вы можете удалить определённые утверждения, добавив в начало строки «-»^[2].

Пример: -Q4115189 TAB P31 TAB Q1

Смысл: удалить из Wikidata Sandbox (Q4115189)instance of (P31)Universe (Q1)

-Q98426308	P585	+1988-05-11T00:00:00Z/11

-Q98426308	P585	+1988-01-01T00:00:00Z/9
-Q98426308	P585	+1988-00-00T00:00:00Z/9

Каждая команда в конце может включать комментарий, который будет помещён в описание правки^[2]. Используйте синтаксис /* ... */. Перед этим может стоять TAB. Пробелы вокруг комментария автоматически удаляются перед обработкой. Инструмент разделяет на две правки добавление заявления и источника. При импортировании «формата версии 1», по-видимому, невозможно задать комментарий к правке, добавляющей источник. Он помещается в описание правки, добавляющей утверждение (если оно на тот момент не существовало и в принципе добавляется).

Пример: Q4115189 TAB P31 TAB Q1 /* Это комментарий. */

Meaning: add to Wikidata Sandbox (Q4115189)instance of (P31)Universe (Q1), with "This is a comment." in the edit summary.

В других колонках могут находиться такие команды:

P1234

A property ID (uppercase) begins a new statement. The column value specifies the main value of the statement, in the same format as in QuickStatements version 1.

qal1234

A lowercase "qal" followed by a property number (without "P") adds a qualifier to the current statement. The column value specifies the value of the qualifier, in QuickStatements version 1 syntax. There must be some "P" column before a "qal" column to specify which statement the qualifier is added to.

S1234

An uppercase "S" followed by a property number (without "P") begins a new source for the current statement. The column value specifies the value of the source, in QuickStatements version 1 syntax. There must be some "P" column before an "S" column to specify which statement the source is added to.

s1234

A lowercase "s" followed by a property number (without "P") adds another property-value pair to the current source. The column value specifies the value of the source, in QuickStatements version 1 syntax. There must be some "S" column before an "s" column to specify which source the property-value pair is added to.

Len

An uppercase "L" followed by a language code sets the label in that language.

Dfr

An uppercase "D" followed by a language code sets the description in that language.

Ade

An uppercase "A" followed by a language code adds an alias in that language.

Senwiki

An uppercase "S" followed by a site ID adds a sitelink to that site.

#

A number sign character sets the edit summary (comment) of the preceding command. The tool splits adding of a claim and its reference in two edits. A comment can be added to the edit summary of each of them. For the claim by putting a "#" column between the columns for the claim and its reference, for the reference by putting a "#" column behind its columns. For example:

qid,P21,#,S143,s813,#
Q22124656,Q6581097,comment to claim adding edit,Q24731821,+2017-10-04T00:00:00Z/11,comment to reference adding edit

qid,Len,Den,P31
,Regina Phalange,fictional character,Q95074

Метка

Описание

Alias

Элемент

somevalue is for unknown value Help, novalue for no value Help. F1 and S1 on Lexeme:L123 would have to exist for it to work.

String or external identifiers (external-id)

Одноязычный текст

en для английского языка

Дата/время

Precisions are 9=year, 10=month, 11=day, so the dates are 1856, January 1856 and 1 January 1856.

Image/Commons media file

URL

Coordinates

Количество

 

•  
  Preparing commands in a spreadsheet
•  
  Cut-and-paste the cells directly into the QS import window
•  
  QS преобразовал ваши команды в человекопонятную форму и ожидает подтверждения
•  
  QS выполняет команды. Обратите внимание на кнопку «Стоп».
•  
  QS выполнил задачу.

 

Внимание: As of May 2020, duplicated items may be created in batch mode. Please make sure you can find and merge them! This does not affect frontend mode.

 

• Even if you close your browser or if your computer crashes, the statements will be executed until the last one.
• You can launch several batches in parallel, without slowing down your computer. (The batches seem to be run sequentially)
• You get a unique URL for your batch, to which you can refer later. This page shows some statistics about your run.
• To see all your recent batches click "Your last batch". To see everybody else's recent batches click "Last batches"
• You or a project admin can stop your batch by going to its URL. For instance, if it is realized that the batch is erroneous and you are offline, an admin can stop it immediately (by going to the individual batch page), rather than having to block you.
• If you discover that something went wrong, you can revert the whole batch afterwards

 

Хитрости:

• [[File:Commons to Wikidata QuickStatements.svg|20px|link=https://quickstatements.toolforge.org/#/v1=Q37887397%7CP214%7C%2296480189%22%7CS143%7CQ565]] will encode the URL within a handy clickable icon:   (click it but do not click "run"; pressing it will not work since that item already has that property).
• Pages with QuickStatements URLs may be located through Special:LinkSearch (see here) or through a database query calling externallinks table (see for example here).

- Python

1. ↑ https://wikidata-todo.toolforge.org/quick_statements.php
2. ↑ ^{2.0 2.1 2.2 2.3 2.4 2.5 2.6 2.7} синтаксис работает только в QuickStatements версии 2
3. ↑ Note that due to the way computers operate with floating-point numbers the input format of version 2 may produce undesired results when working with decimal numbers.
4. ↑ https://www.url-encode-decode.com/ is a handy URL encoder/decoder