Shortcut: Help:QS
說明:QuickStatements
QuickStatements(QS)是一個工具,使用一組簡單的文字命令來編輯維基數據項目。該工具可以添加和刪除語句(statement)、標籤(label)、描述(description)和別名(alias),以及添加帶有可選限定詞(qualifier)和參考來源(source)的語句。可以在導入窗口中鍵入命令序列,也可以在電子表格,文本編輯器中創建並粘貼命令序列。還可以通過外部代碼(例如從模板調用Lua並作為URL傳遞)來創建命令序列。在OpenRefine中編輯的數據也可以導出為QuickStatements格式。
工具
QuickStatements工具经历了多次迭代和重写。您应该尽可能始终使用此工具的当前版本。现有几种QuickStatement版本可用:
- QuickStatements版本2(V2)重寫版或稱新介面版(目前版本)
- 釋出歷史
- QuickStatements版本2 (V2) 原始版或稱舊界面版
- QuickStatements版本1 (V1) (已經無法運作)
語法可以有些許不同,其餘的文檔會描述現有版本的語法,但亦會標記在先前版本不支援的部分。
命令序列語法
此工具的V1版本起支持此章节所描述的语法,这有时称作“第一版命令”[1]。
添加简单的语句
您可以通過在工具的文本區域中輸入/粘貼來指定要添加的語句。 語句的不同部分使用TAB或"|"[2]字符分隔。每一個命令都需要換新行或使用「||」[2]字符分隔。 提示:您還可以使用能創建電子表格的軟體,例如Microsoft Excel或LibreOffice Calc;複製/粘貼單元格會自動插入TAB字符。同樣地,Notepad ++之類的文本編輯器也可以用TAB字符(\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 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))
- 帶公差的數量可以輸入為1.2~0.3(在QuickStatements第2版中),與1.2[0.9,1.5](在QuickStatements第1版中)相同,表示1.2±0.3。請注意,由於計算機對浮點數字的操作方式,在處理十進制數字時,第2版的輸入格式可能會產生不理想的結果。
- QuickStatements第一版对数量使用不同的语法:amount[lower,upper]Uxx,其中数量(amount)、下限(lower)和上限(upper)是一个有理数。
- somevalue表示unknown value Help
- novalue表示no value Help。使用novalue及somevalue時,都不應該加上雙引號。这两条语句都可以作为使用CREATE和LAST关键字创建项目语句的一部分。
添加带有限定符的声称
每個「三聯」語句後面可以有無限數量的「限定符對」,即屬性 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. century
earliest 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)
預設情況下,所有來源都會進入同一個「參考群組」(一組屬性/值對)。如果您要在單一指令行中建立多個參考群組,只要在新群組的第一個來源屬性前加上感嘆號即可: 「!Sxx「 而不是 」Sxx"。(在第一個參考群組中,「!」是可選的,不會影響結果)。
備註:
- 若新加入的語句和已有的語句(屬性和值)完全相同,將不會再次添加;但是其參考文獻可能會被添加到語句中。
- 你可以在同一語句中混合使用限定符和參考資料。只要在使用參考文獻時使用Sxx而不是Pxx即可。
- 在QuickStatements第1版中,每項來源聲稱(source claim)都代表一個單獨的參考文獻,即它們沒有被歸入一個參考文獻;現在在QuickStatements第2版中工作正常。
添加标签、别名、描述与网站链接
與添加簡單的文本語句一樣,每個命令(command)必須由一個項目,一個命令和一個帶前後雙引號的字串組成。
- 要為項目添加特定語言的標籤(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)
- 小技巧:可以同时添加多个别名,用管符(「|」)分隔。
- 例如: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 被合併者的Q號 TAB 合併者的Q號
刪除聲稱
您可以通過在一行前端加上「-」來刪除特定的語句。[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]。使用/* ... */语法。注释前可以插入一个TAB,注释周围的空白符号会在处理时自动去除。本工具会使用两次编辑来分别添加陈述及其参考文献。使用第一版格式导入时,可能无法为添加参考文献的编辑添加注释。注释会添加到添加陈述的编辑中(如果所加陈述尚不存在)。
- 示例:Q4115189 TAB P31 TAB Q1 /* 这里是注释。 */
- 表示:Wikidata Sandbox (Q4115189)instance of (P31)Universe (Q1),编辑摘要中附有“这里是注释。”
CSV文件语法
命令
在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,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
- 例如
创建一个新项目。适用于 LibreOffice(貼上到 A1 单元格)
檔案名稱 | 標籤 | 描述 | qid,P31,Len,Den,P18
|
---|---|---|---|
Mona Lisa - the Louvre.jpg | 蒙娜丽莎 | 达·芬奇画作 | =",Q3305213,"""&B2&""","""&C2&""","""""""&A2&""""""""
|
Mona Lisa - the Louvre.jpg | 蒙娜丽莎 | 达·芬奇画作 | ,Q3305213,"蒙娜丽莎","达·芬奇画作","""Mona Lisa - the Louvre.jpg"""
|
移除陈述命令
语句列标题也可以「-」开头,以删除语句。(请注意,这只在整列的标题中有效,在個別值中无效)。目前还不支持移除其他列类型,运行该命令时会出错;不过,可以藉由将sitelinks和标签设置为空字符串(列标题中不含「-」)来移除它们。
qid,P31,-P31
|
---|
Q4115189,Q5,Q5
|
在沙盒項目中添加 human (Q5) 的 P31 值,然后再次删除相同的语句。
逗号和双引号
标签、描述、别名和网站链接不需要使用双引号,除非它们本身包含逗号(,)或双引号(")。
在这种情况下,用两个双引号(如Toys "R" Us → Toys ""R"" Us)替换所有双引号,然后用一对双引号(如"Toys ""R"" Us")将字符串包起来。
示例: Toys "R" Us 、 Patterns, Predictors, and Outcome
qid,Len
|
---|
Q4115189,"Toys ""R"" Us"
|
Q4115189,"Patterns, Predictors, and Outcome"
|
要添加包含双引号(")的字符串值,请把所有双引号替换为两个("")。
As any string value, then wrap it in three double quotes ("""), e.g. """Toys ""R"" Us""".
Samples for Q4115189#P370, notably Toys "R" Us
qid,P370
|
---|
Q4115189,"""Toys ""R"" Us"""
|
Q4115189,"""Patterns, Predictors, and Outcome"""
|
Q4115189,"""Wikidata sandbox item 1"""
|
综合样本
qid,Len,Den,Aen,P31,-P31,P21,P735,qal1545,S248,s214,S143,Senwiki
|
---|
Q4115189,Douglas Adams,author,Douglas Noël Adams,Q5,Q36180,Q6581097,Q463035,"""1""",Q54919,"""113230702""",Q328,Douglas Adams
|
Q4115189,"Toys ""R"" Us",testin sample,Toys R Us,Q5,Q36180,Q6581097,Q463035,"""1""",Q54919,"""113230702""",Q328,"Toys ""R"" Us"
|
按值类型分类的样本
Samples use the sandbox item (Q4115189) and can be pasted directly into QuickStatements for testing. Should be risk-free.
- 标签
qid,Len
|
---|
Q4115189,Sandbox
|
Q4115189,"Patterns, Predictors, and Outcome"
|
Q4115189,"Toys ""R"" Us"
|
- 描述
qid,Den
|
---|
Q4115189,Wikidata item for tests
|
Q4115189,"sample for Patterns, Predictors, and Outcome"
|
Q4115189,"description sample for Toys ""R"" Us"
|
- 别名
qid,Aen
|
---|
Q4115189,Wikidata sandbox
|
Q4115189,"Predictors, Patterns, and Outcome"
|
Q4115189,"Toys ""4"" You"
|
- 项
qid,P369
|
---|
Q4115189,Q5
|
Q4115189,somevalue
|
Q4115189,novalue
|
L123,Q5
|
L123-S1,Q5
|
L123-F1,Q5
|
somevalue表示unknown value Help, novalue表示no value Help。Lexeme:L123中提供F1和S1才有效。
- 字串或外部標識符(外部ID)
qid,P370
|
---|
Q4115189,"""Sandbox"""
|
Q4115189,"""Patterns, Predictors, and Outcome"""
|
Q4115189,"""Toys ""R"" Us"""
|
- 单一语言文本
qid,P1450
|
---|
Q4115189,en:"Sandbox"
|
Q4115189,en:"Toys "R" Us"
|
Q4115189,"en:""Toys ""R"" Us"""
|
Q4115189,"en:""Patterns, Predictors, and Outcome"""
|
en
指英文
- 日期/时间
qid,P577
|
---|
Q4115189,+1856-01-01T00:00:00Z/9
|
Q4115189,+1856-01-01T00:00:00Z/10
|
Q4115189,+1856-01-01T00:00:00Z/11
|
Precisions are 9=year, 10=month, 11=day, so the dates are 1856, January 1856 and 1 January 1856.
- 图像/共享资源媒体文件
qid,P18
|
---|
Q4115189,"""Frans Breydel - A merry company.jpg"""
|
Q4115189,"""'Girl Reading' by Mary Colman Wheeler, El Paso Museum of Art.JPG"""
|
Q4115189,"""Kaubalaeva ""E. Russ"" vrakk.jpg"""
|
Q4115189,"""''L'empereur Napoleon III'' de Franz-Xaver Winterhalter.jpg"""
|
Images are:
- File:Frans Breydel - A merry company.jpg
- File:'Girl Reading' by Mary Colman Wheeler, El Paso Museum of Art.JPG (includes a single quote and a comma)
- File:Kaubalaeva "E. Russ" vrakk.jpg (includes double quotes)
- File:''L'empereur Napoleon III'' de Franz-Xaver Winterhalter.jpg
- URL
qid,P856
|
---|
Q4115189,"""https://example.com/"""
|
Q4115189,"""https://example.com/equalsign=test"""
|
Q4115189,"""https://example.com/underscore_test"""
|
- 坐标
qid,P625
|
---|
Q4115189,@43.26193/10.92708
|
- 数量
qid,P1114
|
---|
Q4115189,10
|
Q4115189,+20
|
Q4115189,+3.1415926
|
Q4115189,-40
|
Q4115189,5.5U11574
|
Q4115189,+60U11573
|
Q4115189,+7.5U11574
|
Q4115189,-80~1.5
|
Q4115189,2.2~0.3
|
Q4115189,+1.2~0.3
|
U11573
指metre (Q11573),U11574
指second (Q11574)。注意1.2~0.3
的结果。
完整示例
完整示例请参见Help:QuickStatements/examples。
运行QuickStatements
使用QuickStatements第二版
Here is how to use QuickStatements (version 2) in basic mode:
- Go to https://quickstatements.toolforge.org
- Make sure you are logged into OAuth and your name is visible in the upper-right corner. If not, then log in.
- Click "New batch".
- For working with Wikimedia Commons Structured Data:
- Look for the pull-down menu Create new command batch for ... and change project from Wikidata to Commons [Batch mode only!]
- You need "M" ids to work on instead of "Q" numbers. Look up the media identifiers for Commons files with the Minefield tool
- Use statements in the form of "MXXXX|PXX|QXXX" or use the CSV format option
- Initiate the query with the "Run" or "Run in the background" button to run it in the batch mode
- Cut and paste your commands. See the syntax in the section above.
- When you are done, click "Import V1 commands" or "Import CSV commands".
- The tool will convert your commands into human-readable form. Inspect them and click "Run" or "Run in the background" to execute
- As your commands are being processed, double-check the results, and press "STOP" if you detect a problem.
- The user interface will tell you when all commands have been processed.
-
在电子表格中编写命令
-
Cut-and-paste the cells directly into the QS import window
-
QS converted your commands into human-readable form and waits for approval
-
QS executing the commands. Please see "Stop" button.
-
QS completed the task.
使用QuickStatements第一版
仍然提供QuickStatements第一版,但已不再维护。对部分用户而言,这可能已不再可用。
- 访问https://wikidata-todo.toolforge.org/quick_statements.php
- 粘贴您的命令到窗口
- 点击运行(Do it)
- 用户界面会告知语句的执行进度。
使用QuickStatements第二版的批处理模式
警告: 截至2020年5月,批处理模式可能会创建重复的项。请确保您找到并合并它们!这不影响前端模式。 |
何时使用批处理模式?
批处理模式是一种在后台异步运行的批量处理模式,您的表述通过维基媒体服务器而非您的网页浏览器执行。这带来几项优点:
- 即使您关闭了浏览器(无论有意或意外),语句也会执行到末尾。
- 您可以启动多个批次,而不占用您的计算机资源。批次会按顺序运行。
- 您的批处理会被赋予一个唯一网址,之后可以查阅该网址查看任务相关的统计数据。
- “您最近的批处理”页面中,您可以查看自己最近运行的批处理。而“"最近的批处理"”页面可以查看最近所有人运行的批处理。
- 您、或者本项目的管理员,可以通过批处理的唯一网址停止其运行。例如当您不在线而管理员注意到任务异常时,管理员可通过任务页面停止任务,而不必封禁您的账号。
- 如果您注意到任务出现重大问题,可以在执行后还原整个批处理的行为。
但其也有弊端:
- 需要多点几次。所以从经验而言,如果语句不足10条,建议在一般模式下运行。
- 取决于服务器繁忙程度,您的批处理启动可能会延迟片刻,从而无法立即检阅运行结果。
- 批处理的语句数量有限制,超过限制的批处理不能正常加载(显示空白页、持续加载中)。对简单的语句,每个批处理大约能放2.5万条语句,但复杂的语句则少很多。
- 批处理模式适合没有限定符和参考资料的简单语句,而复杂语句会显著增加出错率(例如添加限定符时需要基本语句已经建立)。
用批处理运行前,最好用一般模式直接运行部分命令,以更好了解将要执行的操作。
使用批处理模式
- 按使用QuickStatements第二版章节所说的方式,准备好您的语句
- 相比点击“运行”按钮,改为点击“后台运行”
- “您最近的批处理”页面会显示出您最近运行的批处理任务,及任务的统计数据。
提供有下列统计数据:
- DONE:成功运行的语句总数
- ERROR:失败的语句总数
- INIT:准备运行的语句总数
- RUN:正在运行的语句总数
通过网址运行QuickStatements
An alternative way of communicating with QuickStatements is to use a URL instead of cutting and pasting commands into the import window. For example, a command to add to Emile Justin Merlot (Q37887397)VIAF ID (P214)"96480189" with source imported from Wikimedia project (P143)Wikimedia Commons (Q565) is Q37887397 TAB P214 TAB "96480189" TAB S143 TAB Q565. You can also generate a prefilled QuickStatements window with https://quickstatements.toolforge.org/#/v1= Q37887397%7CP214 %7C%2296480189%22%7C S143%7CQ565 or https://quickstatements.toolforge.org/#/v1=Q37887397%7CP214%7C%2296480189%22%7CS143%7CQ565. The steps of converting V1 syntax to URL are:
- replace TAB with "|" and newline with "||"
- apply URL encoding to the string, which will replace "|" with "%7C", double quote with "%22", space with "%20", slash "/" with "%2F", etc.[3]
- put https://quickstatements.toolforge.org/#/v1= in front of it
Many templates on Commons, like c:Template:Creator or c:Template:Artwork use that technique to package information that can be imported to Wikidata into a clickable URL.
提示:
[[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
限制
QuickStatements version 2 currently cannot:
- create multiple items that are linked to each other
- set ranks for statements
- set comments when removing statements
- specify calendar for a date statement
- specify precision or globe for a location statement
- add statements to redirected items
- add a second statement with the same property and value but with different qualifiers, since additional qualifiers will be added to the first statement
- remove a qualifier without removing the statement itself
- remove a reference without removing the statement itself
- update badges
- create lexemes
Note that for using QuickStatements, an account needs to be autoconfirmed. Also there is no way for users using bot accounts to mark their edits as bot edit (but there is an open ticket to address that).
常见问题
- QuickStatements能向参考资料陈述添加多项内容吗?
- 可以,现在的QuickStatements可以同时添加如imported from Wikimedia project (P143)与retrieved (P813)(例子)或stated in (P248)与page(s) (P304)。
- 我该如何试验性操作QuickStatements?
- 使用Wikidata Sandbox (Q4115189)?
- 如何报告此工具存在的问题?
- 在讨论页或Wikidata:Project chat中与其他用户交流。得到确认的bug应在了解mw:How to report a bug后报告到Phabricator.
- 如何建议新增功能?
- 可以在本工具的Git页面或者User:Magnus Manske/quick statements2提出,但请注意我们的Magnus很忙。
- 我一次最多输入多少条命令?
- 无正式记载。已测试过运行超1.1万条的命令,但如此大规模的批量运行需要数小时才能完成。
最佳實踐
- QuickStatements支持运行一条到上千条的语句。大规模或可能出现争议的运行应参照Wikidata:Bots中的审批流程。
- 所有用户应避免创建重复的项。
- 所有陈述应按Help:Sources要求提供参考文献。但这对VIAF ID (P214)、RKDartists ID (P650)等标识符而言可能不太重要。
- 如发现问题,执行编辑的用户有责任修正或撤销自己的更改。做法参考移除陈述。
- 此工具不能正确遵守maxlag。这对大多数情况来说不成问题,因为此工具的运行仍受用户自身编辑频次的权限限制。但如果用户持有不受限制的权限(例如管理员),则有可能导致问题。
使用API启动批处理
如果您已在QuickStatements上登录,则可在您的使用者頁面获取token。该页面还包含如何使用token、以编程方式提交批次作業的資訊。您需要至少手动提交过一次服务器端批次作業,才能使用此方式!
编辑分组
QuickStatements第二版会为每组批处理创建编辑分组。您可以讨论或回退一个编辑分组。
EditGroups是一个不属于QuickStatements的外部工具。目前可以在维基数据和维基共享资源的一个实例中使用。其他Wikibase示例中可能不可用。
参见
- YouTube上的操作指南(英文)
- CSV转quick_statements工具,能将適當格式的CSV文件转换为一系列QuickStatements命令。
- 將QuickStatements安装為Wikibase套件一部分的指南
导出為 QuickStatements 的工具
- 在Zotkat中,导出並將Zotero翻译为QuickStatements格式:允许在Zotero中收集参考文献,然后将其导出为QuickStatements格式,以便上传到Wikidata。
- topictagger:查找可能缺失的main subject (P921)