添加简单陈述

您可以通过在工具的文本区域中输入/粘贴来指定要添加的陈述。陈述的不同部分用TAB 或"|"字符分隔。^[2] 每条命令占一行，或用 "||" 字符分隔。^[2] 提示：您也可以使用电子表格软件，例如Microsoft Excel或LibreOffice Calc；复制/粘贴单元格时会自动插入制表符。此外，像Notepad++这样的文本编辑器也允许将任何符号替换为制表符 (\t)。

每個陈述必須由一個實體（entity）、一個屬性（property）和一個值（value）組成。 「實體」可以是一個項目（item）、属性（property）、一個詞位（lexeme）^[2]、一個詞性^[2]或是一個义项^[2]。 一個值可以是另一個實體、一個字串、一個時間、一個位置或一個數量，取決於屬性類型，或者是特殊值somevalue或novalue之一（見未知值或無值）。

每個部分的格式：

• 在維基數據，項目的編號形式為「Qxx」，而在維基共享资源，它們的編號形式為「Mxx」。在QuickStatements版本1中，如果在文本區域上方的輸入框中填寫了xxwiki值，則可以使用条目名稱而不是q代碼；並可自動檢索正確的項目編號（如果有）。

  例如：Q4115189 TAB P31 TAB Q1

  含义：添加到Wikidata Sandbox (Q4115189)instance of (P31)universe (Q1)

• 属性的形式為「Pxx」。
• 詞位的形式為「Lxxx」。
• 詞形的形式為「Lxxx-Fyy」。
• 义项的形式為「Lxxx-Syy」。
• 字串（包括URL及文本字段的數值，例如外部ID屬性值）必須以半形雙引號前後夾註（像"這樣"）。許多陈述的值使用「字串」格式，包括外部標識符（如VIAF cluster ID (P214)）、檔案名（如image (P18)）或其他頁面名稱（如Commons category (P373)）。

  例如：Q41576278 TAB P373 TAB "Antoni Ignacy Mietelski"

  含义：添加到Antoni Ignacy Mietelski (Q41576278)Commons category (P373)安东尼·伊格纳齐·梅泰尔斯基

  注意：字符串中的某些字符似乎会干扰工具的正常运行。这些字符包括：“_”（下划线）、“”（双引号）、“ ”（空格）、“=”以及可能更多。添加包含这些字符的URL，例如这个或这个，可能会导致失败。包含这些字符的字符串和URL在通过界面与工具交互时可能有效，但在通过 URL 交互时可能会失败。

• 單語文本在「雙引號」前加上語言和冒號的URL，例如en:"Some text"

  例如：Q1214098 TAB P1476 TAB pl:"Krzyżacy"

  含义：添加到The Knights of the Cross (Q1214098)title (P1476)「Krzyżacy」（波蘭語）

• 時間值的格式必須使用如「+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位數。

  如果想设置儒略历的日期，请添加一个额外的“/J”（请参阅此列表以了解何时应该如此做）。

  如果要提交到API，使用"%09"代替TAB、"%2B"代替"+"、"%3A"代替":"、"%2F"代替"/"。

• 位置坐標的形式為@LAT/LON，其中LAT和LON為十進制數。

  例如：Q3669835 TAB P625 TAB @43.26193/10.92708

  含义：將位置加入至San Dalmazio (Q3669835)

• 數量的形式為amount~toleranceUxx^[2]，其中数值和公差為有理數，Uxx為單位的項目編號（Qxx）。Unit和tolerance的數值為可選值，不要在數量定義留下任何空格。

  QuickStatements第一版对数量使用不同的语法：amount[lower,upper]Uxx，其中数值（amount）、下限（lower）和上限（upper）是一个有理数。

  lower, upper為可選值，且必須同時存在或同時不存在。如果存在，則應放在方括號內，並以,分隔。

  amount, lower and upper必须使用 . 作为小数点分隔符，不得使用任何千位分隔符，并且可以以 "+" 或 "-" 开头。

  10, 10U11573, -10[-12.5,-7.5], 0[-5,5]U11573都是有效的數量。（其中U11573表示metre (Q11573)）

  在QuickStatements 版本 2中，带有公差的数量可以输入为1.2~0.3，这与QuickStatements 版本 1中的1.2[0.9,1.5]相同，并且表示1.2±0.3。^[3]

• somevalue表示unknown value Help
• novalue用于no value Help。novalue和somevalue都不应加双引号。这两个语句都可以在CREATE和LAST关键字的项创建陈述中使用。它们在CREATE和LAST语句中不起作用！ 请考虑使用以下占位符：placeholder for "novalue" (Q108474139), placeholder for "somevalue" (Q53569537)

添加带有限定符的陈述

每個「三元组」陈述後面可以有無限數量的「限定符對」，即屬性 TAB 值。

例如：Q41577083 TAB P570 TAB +1600-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 pairs），即來源屬性 TAB 值。來源屬性與「普通」屬性相同，只是它使用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

預設情況下，所有來源都會進入同一個「參考群組」（一組屬性/值對）。如果您要在單一指令行中建立多個參考群組，只要在新群組的第一個來源屬性前加上感嘆號即可：「!Sxx」而不是「Sxx」。（在第一個參考群組中，「！」是可選的，不會影響結果。）

備註：

• 若新加入的陈述和已有陈述（屬性和值）完全相同，將不會再次添加；但是其參考文獻可能會被添加到陈述中。
• 你可以在同一陈述中混合使用限定符和參考資料。只要在使用參考文獻時使用Sxx而不是Pxx即可。
• 在QuickStatements第1版中，每項來源断言（source claim）都代表一個單獨的參考文獻，即它們沒有被歸入一個參考文獻；現在在QuickStatements第2版中工作正常。

添加标签、别名、描述与网站链接

• 要為項目添加特定語言的標籤（label），請將屬性以「Lxx」取代，其中「xx」為語言代碼。

  例如：Q340122 TAB Lpl TAB "Cyprian Kamil Norwid"

  表示：將波蘭語標籤「Cyprian Kamil Norwid」加入至Cyprian Norwid (Q340122)

• 要為項目添加特定語言的別名（alias），請將屬性以「Axx」取代，其中「xx」為語言代碼。

  例如：Q340122 TAB Aen TAB "Cyprjan Kamil Norwid"

  表示：將英語別名"Cyprjan Kamil Norwid"加入至Cyprian Norwid (Q340122)

  小技巧：可以同时添加多个别名，用管符（「|」）分隔。警告：此功能在QS 2.0建立新項目時無效（magnusmanske/quickstatements_rs#3）

  例如：Q340122 TAB Aen TAB "Cyprian Kamil Norwid|Cypryan Kamil Norvid"

• 要為項目添加特定語言的描述（description），請將屬性以「Dxx」取代，其中「xx」為語言代碼。

  例如：Q340122 TAB Dde TAB "polnischer Dichter"

  表示：將德語描述「polnischer Dichter」加入至Cyprian Norwid (Q340122)

• 要為項目添加特定語言的網站連結（sitelink），請將屬性以「Sxxx」取代，其中「xxx」為網站（如enwiki、commonswiki）。

  例如：Q340122 TAB Szhwiki TAB "塞浦路斯·諾爾維特"

  表示：將中文維基百科(塞浦路斯·諾爾維特)連結至Cyprian Norwid (Q340122)

如果你想刪除一個標籤／別名／描述／連結，值必須是空字符串，其餘的命令也一樣。

創建項目

請確保不要創建重複項目！

若要創建新的項目，請輸入「CREATE」，並將該詞獨立為一行。要將陈述添加到新創建的項目中，請使用「LAST」代替Q號，陈述將被添加到最後創建的項目中。

創建新項目、添加網站連結、設置標籤的例子；

CREATE

LAST TAB Sfrwiki TAB "Le croissant magnifique !"

LAST TAB Lfr TAB "Le croissant magnifique !"

表示：創建一個新項目，連結到法語維基百科的w:fr:Le croissant magnifique!，並加上法語標籤"Le croissant magnifique!"

可以用与“CREATE_PROPERTY”相同的方式创建属性，后跟TAB或|和实体类型，例如： 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. 这主要用于第三方Wikibase实例，因为属性创建在维基数据上受到限制。

合併項目

您可以合併兩個項目。較新的項目將被合併，如果成功的話，較新的項目會重定向到較早的項目。

MERGE TAB Q1 TAB Q2

刪除陈述

您可以通過在一行前端加上「-」來刪除特定的陈述。^[2]

例如：-Q4115189 TAB P31 TAB Q1

表示：將Wikidata Sandbox (Q4115189)instance of (P31)universe (Q1)移除

精度>9的日期可以通过其特定日期删除：

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

精度≤9的日期可以使用00-00或01-01作为其月份日期值，因此可能有必要尝试删除两者：

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

此外，可以使用以下語法刪除帶有特定陈述ID的陈述。

-STATEMENT TAB Q1$00000000-0000-0000-0000-000000000000

語句ID可以透過以下方式接收：

• 任何实体页面的源代码，其中ID可以在带有「wikibase-statementview」类的<div>元素中找到。
• API
• RDF中可被查詢服務查詢的陈述節點的名稱（需要將實體ID後面的-替換為$）

注释

每条命令末尾都可以添加注释，该注释将被插入到命令的编辑摘要中^[2]。使用 /* ... */ 语法。注释前的空格将被移除。该工具会将添加断言及其参考文献的操作拆分为两次编辑。使用“版本 1 格式”导入时，似乎无法为添加参考文献的编辑添加注释。注释会被添加到添加断言的编辑中（如果该断言尚不存在且确实被添加）。

示例：Q4115189 TAB P31 TAB Q1 /* 这里是注释。 */

表示：Wikidata Sandbox (Q4115189)instance of (P31)universe (Q1)，编辑摘要中附有“这里是注释。”

命令

在QuickStatements v2中，还可以剪切和粘贴结构正确的CSV文件，作为QuickStatements v1中引入语法的替代方案。CSV文件将指定要执行的命令（列）及其数据（行）。第一行是标题行，说明如何解释每列中的数据。

例如，稱為P31的列可以包含值Q5，以建立屬性為P31且值為Q5的陈述。

由於某些原因，字串值 需要放在 """三重雙引號"""中。

qid：总是命令的第一列：要编辑的项目或实体。列应包含要编辑的项目或实体的id。如果单元格为空，则将创建一个新项目。请参阅下面的项目创建示例。

其他列可指定如下命令：

P1234

属性ID（大写）开始一个新陈述。列值指定陈述主值的格式与 QuickStatements v1相同。

qal1234

小写的“qal”后面跟一个属性号（不带“P”）为当前陈述添加一个限定符。列值指定QuickStatements v1语法中限定符的值。在“qal”列之前必须有一些“P”列，以指定将限定符添加到哪个陈述。

S1234

大写的“S”后跟属性号（不带“P”）为当前陈述添加新参考文献。列值以QuickStatements v1语法指定参考文献的值。在“S”列之前必须有一些“P”列，以指定将参考文献添加到哪个陈述。

s1234

小写字母“s”后跟属性号（不带“P”），可将另一个属性-值对添加到当前参考文献。列值以QuickStatements v1语法指定源的值。在“s”列之前必须有一些“S”列，以指定将属性-值对添加到哪个参考文献。

Len

大写的“L”后跟一个语言代码可以为该语言设置标签。

Dfr

大写的“D”后跟一个语言代码可以为该语言设置描述。

Ade

大写的“A”后跟一个语言代码可以为该语言设置别名。

Senwiki

大写的“S”后跟网站ID可以添加指向该网站的链接。

#

井号字符用于设置前一条命令的编辑摘要（注释）。该工具将添加断言及其参考文献的操作拆分为两次编辑。可以为每次编辑的编辑摘要添加注释。对于断言，可以在断言及其参考文献所在的列之间添加一个“#”列；对于参考文献，可以在其所在列的后面添加一个“#”列。例如：

qid,P21,#,S143,s813,#
Q22124656,Q6581097,添加断言的注释,Q24731821,+2017-10-04T00:00:00Z/11,添加参考文献的注释

創建項目

要创建一个新项目，该行的第一个元素必须为空，因此该行以,开始。

例如：

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

例如

创建一个新项目。适用于LibreOffice（貼上到A1单元格）

移除陈述命令

陈述列的标题也可以以“-”开头，以删除该陈述。（请注意，这应该在整个列的标题中进行设置，而不是在单个值中设置。）目前尚不支持删除陈述以外的列类型，执行命令时会导致错误；但是，可以通过将站点链接和标签设置为空字符串来删除它们（列标题中无需添加“-”）。

例如，以下代码：

qid,-P462,P462
Q4115189,Q3142,Q3133

……删除陈述Wikidata Sandbox (Q4115189)color (P462)red (Q3142)，然后添加陈述Wikidata Sandbox (Q4115189)color (P462)green (Q3133)。

逗号和双引号

标签、描述、别名和网站链接不需要使用双引号，除非它们本身包含逗号（,）或双引号（"）。

在这种情况下，用两个双引号（如Toys "R" Us → Toys ""R"" Us）替换所有双引号，然后用一对双引号（如"Toys ""R"" Us"）将字符串包起来。

示例: Toys "R" Us 、 Patterns, Predictors, and Outcome

要添加包含双引号（"）的字符串值，请把所有双引号替换为两个（""）。

如果它是字符串值，则用三个双引号 (""") 将其括起来，例如"""Toys ""R"" Us"""。

Q4115189#P370的示例，特别是Toys "R" Us

组合样本

按值类型分类的样本

示例使用了沙盒项目（Q4115189），可以直接粘贴到QuickStatements中进行测试。应该不会有任何风险。

标签

描述

别名

项

somevalue适用于unknown value Help，novalue适用于no value Help。注意：目前在创建新项时，somevalue和novalue无法正常工作！必须先在Lexeme:L123上建立F1和S1，它们才能生效。

字串或外部標識符（外部ID）

单语言文本

en指英文

日期/时间

精确度为9=年，10=月，11=日，因此日期为1856年、1856年1月和1856年1月1日。

图像/共享资源媒体文件

图像是：

• File:Frans Breydel - A merry company.jpg
• File:'Girl Reading' by Mary Colman Wheeler, El Paso Museum of Art.JPG (包括單引號與逗號)
• File:Kaubalaeva "E. Russ" vrakk.jpg (包括雙引號)
• File:''拿破崙三世'' de Franz-Xaver Winterhalter.jpg

URL

坐标

数量

U11573指metre (Q11573)，U11574指second (Q11574)。注意1.2~0.3的结果。

完整示例

完整示例请参见Help:QuickStatements/examples。

使用QuickStatements第二版

下面介绍如何在基本模式下使用QuickStatements（第 2 版）：

1. 访问https://quickstatements.toolforge.org
2. 确保您已登录OAuth，并且您的用户名显示在右上角。如果未登录，请登录。
3. 点击“新建批处理”。
4. 要使用Wikimedia Commons结构化数据：
   1. 找到下拉菜单“为...创建新的命令批处理”，并将项目从Wikidata”更改为“Commons [仅限批处理模式！]”
   2. 您需要使用“M”ID 而不是“Q”编号。使用Minefield 工具查找Commons文件的媒体标识符。
   3. 使用"MXXXX|PXX|QXXX"格式的陈述或使用CSV格式选项。
   4. 点击“运行”或“在后台运行”按钮，以“批处理模式”启动查询。
5. 复制并粘贴您的命令。请参阅上面部分中的语法。
6. 完成后，点击“导入 V1 命令”或“导入 CSV 命令”。
7. 该工具会将您的命令转换为人类可读的格式。检查命令，然后点击“运行”或“在后台运行”执行。
8. 命令处理过程中，请仔细检查结果，如果发现问题，请按“停止”。
9. 用户界面会在所有命令处理完成后通知您。

• 
  在电子表格中编写命令
• 
  将单元格直接复制粘贴到QS导入窗口中
• 
  QS已将您的命令转换为易于理解的形式，并等待您的批准
• 
  QS正在执行命令。请查看“停止”按钮。
• 
  QS 完成了任务。

使用QuickStatements第一版

仍然提供QuickStatements第一版，但已不再维护。对部分用户而言，这可能已不再可用。

1. 访问https://wikidata-todo.toolforge.org/quick_statements.php
2. 粘贴您的命令到窗口
3. 点击运行（Do it）
4. 用户界面会告知语句的执行进度。

使用QuickStatements第二版的批处理模式

警告： 截至2020年5月，批处理模式可能会创建重复的项。请确保您找到并合并它们！这不影响前端模式。

何时使用批处理模式？

批处理模式是一种在后台异步运行的批量处理模式，您的语句通过维基媒体服务器而非您的网页浏览器执行。这带来几项优点：

• 即使您关闭了浏览器（无论有意或意外），语句也会执行到末尾。
• 您可以启动多个批次，而不占用您的计算机资源。批次会按顺序运行。
• 您的批处理会被赋予一个唯一网址，之后可以查阅该网址查看任务相关的统计数据。
• “您最近的批处理”页面中，您可以查看自己最近运行的批处理。而“"最近的批处理"”页面可以查看最近所有人运行的批处理。
• 您、或者本项目的管理员，可以通过批处理的唯一网址停止其运行。例如当您不在线而管理员注意到任务异常时，管理员可通过任务页面停止任务，而不必封禁您的账号。
• 如果您注意到任务出现重大问题，可以在执行后还原整个批处理的行为。

但其也有弊端：

• 需要多点几次。所以从经验而言，如果陈述不足10条，建议在一般模式下运行。
• 取决于服务器繁忙程度，您的批处理启动可能会延迟片刻，从而无法立即检阅运行结果。
• 批处理的陈述数量有限制，超过限制的批处理不能正常加载（显示空白页、持续加载中）。对简单的陈述，每个批处理大约能放2.5万条陈述，但复杂的陈述则少很多。
• 批处理模式适合没有限定符和参考资料的简单陈述，而复杂陈述会显著增加出错率（例如添加限定符时需要基本陈述已经建立）。

用批处理运行前，最好用一般模式直接运行部分命令，以更好了解将要执行的操作。

使用批处理模式

1. 按使用QuickStatements第二版章节所说的方式，准备好您的陈述
2. 相比点击“运行”按钮，改为点击“后台运行”
3. “您最近的批处理”页面会显示出您最近运行的批处理任务，及任务的统计数据。

提供有下列统计数据：

• DONE：成功运行的陈述总数
• ERROR：失败的陈述总数
• INIT：准备运行的陈述总数
• RUN：正在运行的陈述总数

通过网址运行QuickStatements

另一种与QuickStatements交互的方式是使用URL，而不是将命令复制粘贴到导入窗口中。例如，将内容添加到Emile Justin Merlot (Q37887397)VIAF cluster ID (P214)"96480189"并指定来源为imported from Wikimedia project (P143)Wikimedia Commons (Q565)的命令如下： Q37887397 TAB P214 TAB "96480189" TAB S143 TAB Q565。 您还可以使用https://quickstatements.toolforge.org/#/v1= Q37887397%7CP214 %7C%2296480189%22%7C S143%7CQ565或https://quickstatements.toolforge.org/#/v1=Q37887397%7CP214%7C%2296480189%22%7CS143%7CQ565生成预填充的QuickStatements窗口。将V1语法转换为URL的步骤如下：

1. 将TAB替换为 "|"，将换行符替换为 "||"
2. 对字符串应用URL 编码，这将把 "|" 替换为 "%7C"，双引号替换为 "%22"，空格替换为 "%20"，斜杠 "/" 替换为 "%2F" 等。^[4]
3. 在前面添加 https://quickstatements.toolforge.org/#/v1=

Commons 上的许多模板，例如 c:Template:Creator 或 c:Template:Artwork，都使用这种技术将可以导入Wikidata的信息打包成可点击的URL。

提示：

• [[File:Commons to Wikidata QuickStatements.svg|20px|link=https://quickstatements.toolforge.org/#/v1=Q37887397%7CP214%7C%2296480189%22%7CS143%7CQ565]]会将URL编码到一个方便点击的图标中：（点击它，但不要点击“运行”；因为该项目已经具有该属性，所以点击“运行”不会起作用）。
• 可以通过Special:LinkSearch（参见此处链接）或通过调用externallinks表的数据库查询来查找包含QuickStatements URL的页面（例如，参见此处链接）。

导出到QuickStatements的工具

• Zotero导出转换器至QuickStatements格式（在zotkat 中）：允许在Zotero中收集参考文献，然后将其导出到QuickStatements以上传至Wikidata
• topictagger：查找可能缺失的main subject (P921)属性
• New-Q5：用于更新或创建描述人物的项目表单
• Semantic MediaWiki 可以导出文本文件（可粘贴为 Quickstatements V1 格式）或CSV文件（可用作Quickstatements V2格式），通过Templatefile 结果格式实现。