Main Page: Difference between revisions

Jump to navigation Jump to search
Line 144: Line 144:


== Our Wikibase.cloud unboxing experience and first findings ==
== Our Wikibase.cloud unboxing experience and first findings ==
In June-July 2002 the KB created and configured this instance on Wikibase.cloud. Many of the steps we needed to take in the setup process were as to expected when working with fresh MediaWiki instances in general, and Wikidata in particular. However, some steps were not immediately logical, manifest, clearly documemented or simply beyond our (then) knowledge and experience. We created a '''[https://commons.wikimedia.org/wiki/File:KB_Wikibase.cloud_Unboxing_Experience,_Netherlands_Wikibase_Knowlegde_Group,_22-07-2022.pdf presentation]''' in which we share experiences and first impressions of unboxing, setting up, configuring and tweaking '''our [https://kbtestwikibase.wikibase.cloud/wiki/Main_Page Wikibase.cloud test instance]'''. We also present solutions for most of the issues we encountered.  
In June-July 2002 the KB created and configured this instance on Wikibase.cloud. Many of the steps we needed to take in the setup process were as to be expected when working with fresh MediaWiki instances in general, and Wikidata in particular. However, some steps were not immediately logical, manifest, clearly documented or simply beyond our (then) knowledge and experience. We created a '''[https://commons.wikimedia.org/wiki/File:KB_Wikibase.cloud_Unboxing_Experience,_Netherlands_Wikibase_Knowlegde_Group,_22-07-2022.pdf presentation]''' in which we share experiences and first impressions of unboxing, setting up, configuring and tweaking '''our [https://kbtestwikibase.wikibase.cloud/wiki/Main_Page Wikibase.cloud test instance]'''. We also present solutions for most of the issues we encountered.  


Below is an overview of the most important issues we encountered. The numbering refers to the slides in the presentation:  
Below is an overview of the most important issues we encountered. The numbering refers to the corresponding slides in the presentation:  


;Setting up our Wikibase.cloud test instance ([https://commons.wikimedia.org/w/index.php?title=File:KB_Wikibase.cloud_Unboxing_Experience,_Netherlands_Wikibase_Knowlegde_Group,_22-07-2022.pdf&page=2 slide 2] - [https://commons.wikimedia.org/w/index.php?title=File:KB_Wikibase.cloud_Unboxing_Experience,_Netherlands_Wikibase_Knowlegde_Group,_22-07-2022.pdf&page=13 slide 13])  
;Setting up our Wikibase.cloud test instance ([https://commons.wikimedia.org/w/index.php?title=File:KB_Wikibase.cloud_Unboxing_Experience,_Netherlands_Wikibase_Knowlegde_Group,_22-07-2022.pdf&page=2 slide 2] - [https://commons.wikimedia.org/w/index.php?title=File:KB_Wikibase.cloud_Unboxing_Experience,_Netherlands_Wikibase_Knowlegde_Group,_22-07-2022.pdf&page=13 slide 13])  
* We succesfully created our test instance at https://kbtestwikibase.wikibase.cloud via a personal [https://www.wikibase.cloud/dashboard Wikibase.cloud dashboard] every user gets, [https://www.mediawiki.org/wiki/Wikibase/Wikibase.cloud/Wikis as described here]. This went without any problems, as expected.  
* We succesfully created our test instance at https://kbtestwikibase.wikibase.cloud via a personal [https://www.wikibase.cloud/dashboard Wikibase.cloud dashboard] every user gets, [https://www.mediawiki.org/wiki/Wikibase/Wikibase.cloud/Wikis as described here]. This went without any problems, as expected.  
* ISSUE: ''We would have liked to be able to [https://www.wikibase.cloud/wikis/create create another Wikibase.cloud instance]'' from this dashboard, but currently there is a hard limit of [https://phabricator.wikimedia.org/T311121 one instance per account]. There is no solution yet.  
* ISSUE: ''We would have liked to be able to [https://www.wikibase.cloud/wikis/create create another Wikibase.cloud instance]'' from this dashboard, but currently (15th Aug 2022) there is a hard limit of [https://phabricator.wikimedia.org/T311121 one instance per account]. There is no solution yet.  


;Setting up basic content (Ps and Qs) via the GUI ([https://commons.wikimedia.org/w/index.php?title=File:KB_Wikibase.cloud_Unboxing_Experience,_Netherlands_Wikibase_Knowlegde_Group,_22-07-2022.pdf&page=14 slide 14] - [https://commons.wikimedia.org/w/index.php?title=File:KB_Wikibase.cloud_Unboxing_Experience,_Netherlands_Wikibase_Knowlegde_Group,_22-07-2022.pdf&page=29 slide 29])  
;Setting up basic content (Ps and Qs) via the GUI ([https://commons.wikimedia.org/w/index.php?title=File:KB_Wikibase.cloud_Unboxing_Experience,_Netherlands_Wikibase_Knowlegde_Group,_22-07-2022.pdf&page=14 slide 14] - [https://commons.wikimedia.org/w/index.php?title=File:KB_Wikibase.cloud_Unboxing_Experience,_Netherlands_Wikibase_Knowlegde_Group,_22-07-2022.pdf&page=29 slide 29])  
Line 156: Line 156:
* [https://kbtestwikibase.wikibase.cloud/w/index.php?title=Special:CreateAccount&returnto=Main+Page Creating additional, regular user accounts] on this Wiki instance was as expected. We created [[User:OlafJanssen]] with normal, restricted privileges.
* [https://kbtestwikibase.wikibase.cloud/w/index.php?title=Special:CreateAccount&returnto=Main+Page Creating additional, regular user accounts] on this Wiki instance was as expected. We created [[User:OlafJanssen]] with normal, restricted privileges.
* ISSUE: ''Regular user accounts with default privileges are not allowed to add  URLs to items'' (see Phabricator [https://phabricator.wikimedia.org/T310419 T310419], [https://phabricator.wikimedia.org/T86453 T86453] and [https://phabricator.wikimedia.org/T310421 T310421]). In order to be able to add the Wikidata URL to (for instance) [https://kbtestwikibase.wikibase.cloud/wiki/Property:P3 P3] ("is a unique exmple of"), we used the [[User:Ookgezellig]] admin account to temporarily upgrade the [[User:OlafJanssen]] account to admin privileges as well.
* ISSUE: ''Regular user accounts with default privileges are not allowed to add  URLs to items'' (see Phabricator [https://phabricator.wikimedia.org/T310419 T310419], [https://phabricator.wikimedia.org/T86453 T86453] and [https://phabricator.wikimedia.org/T310421 T310421]). In order to be able to add the Wikidata URL to (for instance) [https://kbtestwikibase.wikibase.cloud/wiki/Property:P3 P3] ("is a unique exmple of"), we used the [[User:Ookgezellig]] admin account to temporarily upgrade the [[User:OlafJanssen]] account to admin privileges as well.
* IMPORTANT: the Wikidata URL in [https://kbtestwikibase.wikibase.cloud/wiki/Property:P3 P3] must be formatted as '''http:'''//www.wikidata.org/'''entity'''/P31, and NOT as http'''s'''://www.wikidata.org/entity/P31, and NOT as <nowiki>https://www.wikidata.org/</nowiki>'''wiki/Property:'''P31, or any other mix of these incorrect URLs. This is important for correctly functioning, abbreviated display of these URLS in the Wikibase query service ([http://www.wikidata.org/entity/P31 wd:P31], as can be seen in the query result <nowiki>https://tinyurl.com/2kd5dthd</nowiki>).
* IMPORTANT: the Wikidata URL in [https://kbtestwikibase.wikibase.cloud/wiki/Property:P3 P3] must be formatted as '''http:'''//www.wikidata.org/'''entity'''/P31, and NOT as http'''s'''://www.wikidata.org/entity/P31, and NOT as <nowiki>https://www.wikidata.org/</nowiki>'''wiki/Property:'''P31, or any other mix of these incorrect URL syntaxes. This is important for correctly functioning, abbreviated display of these URLs in the Wikibase query service ("[http://www.wikidata.org/entity/P31 wd:P31]", as can be seen in the query result <nowiki>https://tinyurl.com/2kd5dthd</nowiki>).
* ISSUE: When adding statements to a Q-item such as [[Item:Q29|Theun de Vries]], ''by default the statements are (and remain) displayed in the same order as you originally added them''. This is different from Wikidata, where in the corresponding [https://www.wikidata.org/wiki/Q2143934 Wikidata item about Theun de Vries] the statements are displayed in a custom, fixed order, with "Instance of" and "Image" on top, and a list of external identifiers at the bottom of the page, irrespective of the exacty order these statements were originally added to this Wikidata item. This issue was solved by adding the page [[MediaWiki:Wikibase-SortedProperties]] to the Wikibase, in which the custom order of statements can be specified. This is the same as in Wikidata, see [https://www.wikidata.org/wiki/MediaWiki:Wikibase-SortedProperties MediaWiki:Wikibase-SortedProperties] and [https://www.mediawiki.org/wiki/Manual:Interface/Wikibase-SortedProperties the manual] on Wikidata. Please note that the required page cache purging needed for this functionality to kick in can be actively triggered via [[Special:Purge]].         
* ISSUE: When adding statements to a Q-item such as [[Item:Q29|Theun de Vries]], ''by default the statements are (and remain) displayed in the same order as you originally added them''. This is different from Wikidata, where in the corresponding [https://www.wikidata.org/wiki/Q2143934 Wikidata item about Theun de Vries] the statements are displayed in a custom, fixed order, with "Instance of" and "Image" on top, and a list of external identifiers at the bottom of the page, irrespective of the exacty order these statements were originally added to this Wikidata item. This issue was solved by adding the page [[MediaWiki:Wikibase-SortedProperties]] to the Wikibase, in which the custom order of statements can be specified. This is the same as in Wikidata, see [https://www.wikidata.org/wiki/MediaWiki:Wikibase-SortedProperties MediaWiki:Wikibase-SortedProperties] and [https://www.mediawiki.org/wiki/Manual:Interface/Wikibase-SortedProperties the manual] on Wikidata. Please note that the required page cache purging needed for this functionality to kick in can be actively triggered via [[Special:Purge]].         


Line 163: Line 163:
* ISSUE: ''the Wikidata [https://www.wikidata.org/wiki/Template:SPARQL SPARQL template] for query syntax highlighting is not implemented in this Wikibase''. Instead one must use a ''<nowiki><sparql tryit="1">...</sparql></nowiki>'' wrapper, as demonstrated [https://kbtestwikibase.wikibase.cloud/w/index.php?title=Project:SPARQL/examples&action=submit in this example].   
* ISSUE: ''the Wikidata [https://www.wikidata.org/wiki/Template:SPARQL SPARQL template] for query syntax highlighting is not implemented in this Wikibase''. Instead one must use a ''<nowiki><sparql tryit="1">...</sparql></nowiki>'' wrapper, as demonstrated [https://kbtestwikibase.wikibase.cloud/w/index.php?title=Project:SPARQL/examples&action=submit in this example].   
* ISSUE: ''in Wikidata prefixes don't need to be specified explicitly in SPARQL queries''. However, in our Wikibase.cloud instance, prefixes must be explicitly stated, as [[Project:SPARQL/examples#Federated_querying:_mixing_data_from_this_Wikibase_with_data_from_Wikidata|this example]] shows. Please note and mind the distinction between PREFIX kbwdt, kbwd, wdt and  wd.  
* ISSUE: ''in Wikidata prefixes don't need to be specified explicitly in SPARQL queries''. However, in our Wikibase.cloud instance, prefixes must be explicitly stated, as [[Project:SPARQL/examples#Federated_querying:_mixing_data_from_this_Wikibase_with_data_from_Wikidata|this example]] shows. Please note and mind the distinction between PREFIX kbwdt, kbwd, wdt and  wd.  
* IMPORTANT: The exact URL [https://kbtestwikibase.wikibase.cloud/wiki/Project:SPARQL/examples https://kbtestwikibase.wikibase.cloud/wiki/'''Project:SPARQL/examples'''], as well as the correct formatting of this page, are important to correctly display these query examples in the [https://kbtestwikibase.wikibase.cloud/query/# query services interface] (click the Examples button at the top)  
* IMPORTANT: The exact URL [https://kbtestwikibase.wikibase.cloud/wiki/Project:SPARQL/examples https://kbtestwikibase.wikibase.cloud/wiki/'''Project:SPARQL/examples'''], as well as the correct formatting of this page, are important to correctly display these query examples in the [https://kbtestwikibase.wikibase.cloud/query/# query services interface] (click the ''Examples'' button at the top)  
* Via the regular [https://kbtestwikibase.wikibase.cloud/w/api.php Wikimedia REST API] the full [[Item:Q29|item on Theun de Vries]] can be requested [https://kbtestwikibase.wikibase.cloud/w/api.php?action=wbgetentities&ids=Q29&format=json as JSON] or [https://kbtestwikibase.wikibase.cloud/w/api.php?action=wbgetentities&ids=Q29&format=xml as XML] as well. 
* An alternative way for requesting full Wikibase items directly from the Qnumber is via the [https://www.mediawiki.org/wiki/Wikibase/EntityData Special:EntityData] URL. The ouput can be obtained in seven different formats: [[Special:EntityData/Q29|HTML]], [[Special:EntityData/Q29.json|JSON]], [[Special:EntityData/Q29.rdf|RDF/XML]], [[Special:EntityData/Q29.nt|NT]], [[Special:EntityData/Q29.ttl|TTL]], [[Special:EntityData/Q29.n3|N3]] and [[Special:EntityData/Q29.php|PHP]]. Or equivalently, using a format argument, eg [https://kbtestwikibase.wikibase.cloud/wiki/Special:EntityData?id=Q29&format=json Special:EntityData?id=Q29&format=json] for a JSON respons. 
*
 
 
 




* Federated query in Wikibase and Wikidata, mind the prefixes: https://kbtestwikibase.wikibase.cloud/wiki/Project:SPARQL/examples#Federated_querying:_mixing_data_from_this_Wikibase_with_data_from_Wikidata
* Theun de Vries on Wikibase: https://kbtestwikibase.wikibase.cloud/wiki/Item:Q29
* Theun de Vries Wikibase item in JSON and XML: https://kbtestwikibase.wikibase.cloud/w/api.php?action=wbgetentities&ids=Q29&format=json + https://kbtestwikibase.wikibase.cloud/w/api.php?action=wbgetentities&ids=Q29&format=xml
* Or equivalently: https://kbtestwikibase.wikibase.cloud/wiki/Special:EntityData/Q29.json + https://kbtestwikibase.wikibase.cloud/wiki/Special:EntityData/Q29.ttl + https://kbtestwikibase.wikibase.cloud/wiki/Special:EntityData/Q29.php
* Wikibase REST API interaction/library in Python: https://github.com/samuelmeuli/wikibase-api + Documentation: https://wikibase-api.readthedocs.io/en/latest/getting_started/installation_and_usage.html
* Wikibase REST API interaction/library in Python: https://github.com/samuelmeuli/wikibase-api + Documentation: https://wikibase-api.readthedocs.io/en/latest/getting_started/installation_and_usage.html
* Code examples on how to use this Python library: https://github.com/KBNLresearch/wikibase-api/tree/master/examples-kb + https://github.com/kbnlresearch/wikibase-api/blob/master/examples-kb/wikibase-api.py
* Code examples on how to use this Python library: https://github.com/KBNLresearch/wikibase-api/tree/master/examples-kb + https://github.com/kbnlresearch/wikibase-api/blob/master/examples-kb/wikibase-api.py


;3 problems we encounterd, yet unsolved ([https://commons.wikimedia.org/w/index.php?title=File:KB_Wikibase.cloud_Unboxing_Experience,_Netherlands_Wikibase_Knowlegde_Group,_22-07-2022.pdf&page=14 slide 14] - [https://commons.wikimedia.org/w/index.php?title=File:KB_Wikibase.cloud_Unboxing_Experience,_Netherlands_Wikibase_Knowlegde_Group,_22-07-2022.pdf&page=xx slide xx])  
;3 problems we encounterd, yet unsolved ([https://commons.wikimedia.org/w/index.php?title=File:KB_Wikibase.cloud_Unboxing_Experience,_Netherlands_Wikibase_Knowlegde_Group,_22-07-2022.pdf&page=14 slide 14] - [https://commons.wikimedia.org/w/index.php?title=File:KB_Wikibase.cloud_Unboxing_Experience,_Netherlands_Wikibase_Knowlegde_Group,_22-07-2022.pdf&page=xx slide xx])  
emailconfirmed
952

edits

Navigation menu