emailconfirmed
952
edits
Main Page: Difference between revisions
→Our Wikibase.cloud unboxing experience and first findings
OlafJanssen (talk | contribs) |
OlafJanssen (talk | contribs) |
||
| Line 150: | Line 150: | ||
;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 (15th Aug 2022) 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]. | ||
: SOLUTION: 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]) | ||
* As can be seen from the [https://kbtestwikibase.wikibase.cloud/wiki/Special:ListUsers users list], there is a preset default admin [[User:Ookgezellig]] account for this instance, resulting from the global wikibase.cloud creation account (ookgezellig@gmail.com) | * As can be seen from the [https://kbtestwikibase.wikibase.cloud/wiki/Special:ListUsers users list], there is a preset default admin [[User:Ookgezellig]] account for this instance, resulting from the global wikibase.cloud creation account (ookgezellig@gmail.com) | ||
* [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]). | ||
: SOLUTION: 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 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>). | * 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. | ||
: SOLUTION: 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]]. | |||
;SPARQL and REST APIs ([https://commons.wikimedia.org/w/index.php?title=File:KB_Wikibase.cloud_Unboxing_Experience,_Netherlands_Wikibase_Knowlegde_Group,_22-07-2022.pdf&page=30 slide 30] - [https://commons.wikimedia.org/w/index.php?title=File:KB_Wikibase.cloud_Unboxing_Experience,_Netherlands_Wikibase_Knowlegde_Group,_22-07-2022.pdf&page=43 slide 43]) | ;SPARQL and REST APIs ([https://commons.wikimedia.org/w/index.php?title=File:KB_Wikibase.cloud_Unboxing_Experience,_Netherlands_Wikibase_Knowlegde_Group,_22-07-2022.pdf&page=30 slide 30] - [https://commons.wikimedia.org/w/index.php?title=File:KB_Wikibase.cloud_Unboxing_Experience,_Netherlands_Wikibase_Knowlegde_Group,_22-07-2022.pdf&page=43 slide 43]) | ||
* We created a small number of [[Project:SPARQL/examples|SPARQL query examples]] on this Wikibase. | * We created a small number of [[Project:SPARQL/examples|SPARQL query examples]] on this Wikibase. | ||
* 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''. | ||
* | : SOLUTION: 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]. | ||
* IMPORTANT: ''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. | * 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. | ||
| Line 170: | Line 174: | ||
: Examples on how to use this library are available at https://github.com/KBNLresearch/wikibase-api/tree/master/examples-kb + https://github.com/kbnlresearch/wikibase-api/blob/master/examples-kb/wikibase-api.py | : Examples on how to use this library are available at https://github.com/KBNLresearch/wikibase-api/tree/master/examples-kb + https://github.com/kbnlresearch/wikibase-api/blob/master/examples-kb/wikibase-api.py | ||
; | ;Three 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=44 slide 44] - [https://commons.wikimedia.org/w/index.php?title=File:KB_Wikibase.cloud_Unboxing_Experience,_Netherlands_Wikibase_Knowlegde_Group,_22-07-2022.pdf&page=52 slide 52]) | ||
* ISSUE: ''Regular user accounts with default privileges are not allowed to add URLs to items'' | |||
: SOLUTION: See discussion above | |||
* ISSUE: ''Creation of common.js and common.css pages on Wikibase.cloud instances is not allowed.'' On Wikidata, users (eg. [https://www.wikidata.org/wiki/User:OlafJanssen User:OlafJanssen]) can create personal [https://www.wikidata.org/wiki/User:OlafJanssen/common.js common.js] and [https://www.wikidata.org/wiki/User:OlafJanssen/common.css common.css] pages for adding custom functionalities and layout to their Wikidata interfaces. On Wikibase.cloud, this is currently not possible. | |||
: SOLUTION: No solution yet, see Phabricator [https://phabricator.wikimedia.org/T310787 T310787]. | |||
* ISSUE: ''Default data import speed is rather limited''. When importing items into a Wikibase using REST API-based tools such as [https://www.wikidata.org/wiki/Help:QuickStatements QuickStatements], [https://www.mediawiki.org/wiki/Manual:Pywikibot pywikibot] or [https://github.com/SuLab/WikidataIntegrator WikidataIntegrator], the maximum import speed is about 3-10 items per second, as explained in the article ''[https://www.wikibase.consulting/fast-bulk-import-into-wikibase/ Fast Bulk Import Into Wikibase]'' by [https://www.wikibase.consulting/ The Wikibase Consultancy]. This is an OK speed for small datasets, but if you (like the KB) plan to import millions of items, this is obviously too slow. | |||
: SOLUTION: PHP scripts or direct SQL tools such as [https://github.com/UB-Mannheim/RaiseWikibase RaiseWikibase], as further outlined in the article. | |||
;Where to get help? ([https://commons.wikimedia.org/w/index.php?title=File:KB_Wikibase.cloud_Unboxing_Experience,_Netherlands_Wikibase_Knowlegde_Group,_22-07-2022.pdf&page=53 slide 53] - [https://commons.wikimedia.org/w/index.php?title=File:KB_Wikibase.cloud_Unboxing_Experience,_Netherlands_Wikibase_Knowlegde_Group,_22-07-2022.pdf&page=58 slide 58]) | |||
;Where to get help? ([https://commons.wikimedia.org/w/index.php?title=File:KB_Wikibase.cloud_Unboxing_Experience,_Netherlands_Wikibase_Knowlegde_Group,_22-07-2022.pdf&page= | |||
# Wikibase.cloud issues on Phabricator: https://phabricator.wikimedia.org/tag/wikibase.cloud/ | # Wikibase.cloud issues on Phabricator: https://phabricator.wikimedia.org/tag/wikibase.cloud/ | ||
# Wikibase.cloud updates: https://meta.wikimedia.org/wiki/Wikibase/Wikibase.cloud | # Wikibase.cloud updates: https://meta.wikimedia.org/wiki/Wikibase/Wikibase.cloud | ||