Main Page: Difference between revisions
OlafJanssen (talk | contribs) |
OlafJanssen (talk | contribs) |
||
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. | |||
Below is an overview of the most important issues we encountered. The numbering behind each issue refers to the slides in the presentation: | |||
;Setting up our Wikibase.cloud test instance (slides [https://commons.wikimedia.org/w/index.php?title=File:KB_Wikibase.cloud_Unboxing_Experience,_Netherlands_Wikibase_Knowlegde_Group,_22-07-2022.pdf&page=2 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 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 would have liked to be able to [https://www.wikibase.cloud/wikis/create create another instance] from this dashboard, but currently there is a hard limit of [https://phabricator.wikimedia.org/T311121 one instance per account]. | |||
* | |||
* | |||
;Setting up basic content (Ps and Qs) via the GUI | ;Setting up basic content (Ps and Qs) via the GUI | ||
* KB Wikibase.cloud test instance homepage: https://kbtestwikibase.wikibase.cloud/wiki/Main_Page | * KB Wikibase.cloud test instance homepage: https://kbtestwikibase.wikibase.cloud/wiki/Main_Page |
Revision as of 11:37, 10 August 2022
Test Wikibase instance for the national library of The Netherlands.
Quick links
Eigenschappen (properties) (namespace 122)
Basiseigenschappen voor personen
- is een uniek exemplaar van (waarde: Q-nummer van mens)
- NTA-label
- voornaam
- voornaam (als tekenreeks)
- achternaam
- achternaam (als tekenreeks)
- sekse of geslacht (waarde: Q-nummer van man of vrouw)
- land van nationaliteit
- land van nationaliteit (tweeletterige landcode als tekenreeks)
- geboortedatum (EDTF)
- geboorteplaats
- geboorteplaats (als tekenreeks)
- overlijdensdatum (EDTF)
- overlijdensplaats
- overlijdensplaats (als tekenreeks)
- beroep
- beroep (als tekenreeks)
- PPN identificatiecode voor persoonsnaam
- VIAF-identificatiecode
- DBNL-identificatiecode voor auteur
- ISNI-identificatiecode
- LCAuth-identificatiecode
- Wikidata URI
- Wikidata Qid
Basiseigenschappen voor werken
- is een uniek exemplaar van
- subklasse van
- titel
- beschrijving
- taal van werk
- taal van werk (als tekenreeks)
- genre
- genre (als tekenreeks)
- auteur
- auteur (als tekenreeks)
- illustrator
- illustrator (als tekenreeks)
- uitgever
- uitgever (als tekenreeks)
- plaats van publicatie
- plaats van publicatie (als tekenreeks)
- datum van uitgave (EDTF)
- in collectie
- in collectie (als tekenreeks)
- inventarisnummer
- gebruikt materiaal
- gebruikt materiaal (als tekenreeks)
- PPN identificatiecode voor het oorspronkelijke fysieke werk
- Wikidata URI
- Wikidata Qid
Items (namespace 120)
Basisitems algemeen
Basisitems voor personen
Basisitems voor werken
Terminologie
- https://www.wikidata.org/wiki/Help:Statements
- Entity: een Item (Qnummer) of een Property (Pnummer, Eigenschap)
- A statement consists of a property(P)-value(Q) pair, for example, "location: Germany."
- Statements can also be expanded upon, annotated, or contextualized with the addition of optional qualifiers, references, and ranks.
- The core part of a statement without references and ranks is also called claim. A claim without qualifiers is also referred to as snak. (= simplest P-Q pair)
Voorbeeld-items
om (het API-matig schrijven van) onze KB-datamodellen te testen en te verbeteren. Het zijn 1e, naieve schetsen, "praatstukken" om bij de datamodellering te helpen.
Centsprenten
- Q20 - Adam en Eva uit het paradijs verjaagd - basaal Qitem dat een fysieke KB-centsprent beschrijft.
- Voer voor discussie:
- Let op: Q20 beschrijft de fysieke centsprent , zie nbc.bibliotheek.nl/32226085X en KB-catalogus/32226085X.
- Er is ook een PPN voor de gedigitaliseerde centsprent, zie nbc.bibliotheek.nl/380352362 en KB-catalogus/380352362, maar dat is een ander, digitaal object, een digitaal bestand, een jpg.
- De conceptuele vraag die we i.h.k.v. EMMA moeten beantwoorden is hoe de fysieke en gedigitaliseerde objecten zich tot elkaar moeten verhouden, dus hoe we die relatie in onze Wikibase willen gaan vastleggen. Het aanmaken van 2 aparte Qitems , 1 voor de fysieke prent (PPN=32226085X), en 1 voor het jpg-bestand (PPN=380352362) - dus zoals het op dit moment ook in de GGC en KB-catalogus gebeurt, is mi (=Olaf) niet wenselijk, maar daar moeten we (mn. Danielle en ik) met de KB-metadata-experts een keer voor gaan zitten.
- De GGC/KB-catalogus is hierin ook niet zuiver. Als je bv naar de beschrijving van het digitale ding ("de jpg") kijkt op https://webggc.oclc.org/cbs/DB=2.37/XMLPRS=Y/PPN?PPN=380352362, dan staan daar nog allerlei velden in die met het fysieke ding te maken hebben. Bv bij "Jaar van vervaardiging" - het jaar waarin de jpg gemaakt is - zou ik "2009" ipv "[tussen 1869 en 1886]" verwachten, want in de 19e eeuw kon men nog helemaal geen jpgs maken. Bij de beschrijving van het digitale bestand zou ik properties als resolutie, kleurdiepte, bestandsformaat (jpg, png, tiff..), EXIF-info, URL etc. verwachten.
Personen
Basale Qitems die mensen van vlees en bloed beschrijven
- Q10 - Louis Auguste Gustave Doré
- Q29 - Theun de Vries
- Openstaande issues (Phabricator):
- Allow custom ordering of properties in wikibase.cloud instances --> Opgelost, sortering is nu aanpasbaar. Zie oplossing in https://phabricator.wikimedia.org/T310899 , Olaf heeft https://kbtestwikibase.wikibase.cloud/wiki/MediaWiki:Wikibase-SortedProperties aangemaakt en de paginacache geleegd via Special:Purge.
- Clustering of external ID properties in Qitems in wikibase.cloud (as in Wikidata) --> hangt met bovenstaande samen
Openstaand vragen:
- Welke datamodel zit er achter de personen die we in onze Wikibase gaan beschrijven? Moeten/kunnen we aansluiten bij (hergebruik maken van) reeds bestaande datamodellen over personen en persoonsnamen?
SPARQL
Setup
- SPARQL-queries zijn mogelijk via https://kbtestwikibase.wikibase.cloud/query/
- Er moeten voorlopig verplicht prefixen meegegeven worden (volgens de prefixen die in Wikidata gebruikt worden):
PREFIX wd: <https://kbtestwikibase.wikibase.cloud/entity/>
PREFIX wds: <https://kbtestwikibase.wikibase.cloud/entity/statement/>
PREFIX wdv: <https://kbtestwikibase.wikibase.cloud/value/>
PREFIX wdt: <https://kbtestwikibase.wikibase.cloud/prop/direct/>
PREFIX wikibase: <http://wikiba.se/ontology#>
PREFIX p: <https://kbtestwikibase.wikibase.cloud/prop/>
PREFIX ps: <http://www.wikidata.org/prop/statement/>
PREFIX xsd: <http://www.w3.org/2001/XMLSchema#>
Queries
- Zie deze voorbeelden van SPARQL queries - de queries op deze pagina worden in de Voorbeelden-dropdown op https://kbtestwikibase.wikibase.cloud/query/ weergegeven.
Interactie via de API
Endpoint / base URL
Via URLs
- Een voorbeeld om item Q1 op te vragen als JSON: https://kbtestwikibase.wikibase.cloud/w/api.php?action=wbgetentities&ids=Q1&format=json
- Q1 en Q2 samen als JSON: https://kbtestwikibase.wikibase.cloud/w/api.php?action=wbgetentities&ids=Q1%7CQ2&format=jsonfm (of als XML)
Via Python
- https://github.com/KBNLresearch/wikibase-api/tree/master/examples-kb - Examples on how to read, write, delete, update Ps, Qs, claims, qualifiers and references in https://kbtestwikibase.wikibase.cloud using Python
- Docs/manual are on https://wikibase-api.readthedocs.io/en/latest/.
Nog verder bekijken, waarschijnlijk relevant
Snelheid van bulk data-importeren
- Fast Bulk Import Into Wikibase - Importing a large amount of Items into Wikibase can be a challenge. This post provides a high level overview of different importing approaches and their performance.
Wikibase.cloud project updates
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 presentation in which we share experiences and first impressions of unboxing, setting up, configuring and tweaking our 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 behind each issue refers to the slides in the presentation:
- We succesfully created our test instance at https://kbtestwikibase.wikibase.cloud via a personal Wikibase.cloud dashboard every user gets, as described here. This went without any problems, as expected.
- We would have liked to be able to create another instance from this dashboard, but currently there is a hard limit of one instance per account.
- Setting up basic content (Ps and Qs) via the GUI
- KB Wikibase.cloud test instance homepage: https://kbtestwikibase.wikibase.cloud/wiki/Main_Page
- Create user account on this Wikibase: https://kbtestwikibase.wikibase.cloud/w/index.php?title=Special:CreateAccount&returnto=Main+Page
- Users of this Wiki + privileges: https://kbtestwikibase.wikibase.cloud/wiki/Special:ListUsers
- Date of birth (EDTF) property: https://kbtestwikibase.wikibase.cloud/wiki/Property:P61
- Theun de Vries on Wikidata: https://www.wikidata.org/wiki/Q2143934
- Theun de Vries on Wikibase: https://kbtestwikibase.wikibase.cloud/wiki/Item:Q29
- Allow custom ordering of properties in wikibase.cloud instances: https://phabricator.wikimedia.org/T310899
- Clustering of external ID properties in Qitems in Wikibase.cloud (as in Wikidata): https://phabricator.wikimedia.org/T310898
- Custum sorting of properties in Wikibase: https://kbtestwikibase.wikibase.cloud/wiki/MediaWiki:Wikibase-SortedProperties
- Custum sorting of properties in Wikidata: https://www.wikidata.org/wiki/MediaWiki:Wikibase-SortedProperties + Manual: https://www.mediawiki.org/wiki/Manual:Interface/Wikibase-SortedProperties
- Purge cache of pages: https://kbtestwikibase.wikibase.cloud/wiki/Special:Purge
- SPARQL and REST APIs
- SPARQL examples on this Wikibase: https://kbtestwikibase.wikibase.cloud/wiki/Project:SPARQL/examples
- <sparql tryit="1">: https://kbtestwikibase.wikibase.cloud/w/index.php?title=Project:SPARQL/examples&action=submit
- 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
- 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
- Wikibase property "is a unique exmple of": https://kbtestwikibase.wikibase.cloud/wiki/Property:P3
- Useless red error pops up when non confirmed user tries to add a URL on wbcloud: https://phabricator.wikimedia.org/T310419 + Cannot add url values as an anonymous or unconfirmed user: https://phabricator.wikimedia.org/T86453 + Disable captcha in entity namespaces until T87854 is fixed: https://phabricator.wikimedia.org/T310421
- Olaf Janssen's user scripts + custom CSS on Wikidata: https://www.wikidata.org/wiki/User:OlafJanssen/common.js + https://www.wikidata.org/wiki/User:OlafJanssen/common.css
- Allow creation of common.js and common.css on wikibase.cloud instances for normal users: https://phabricator.wikimedia.org/T310787
- Fast Bulk Import Into Wikibase: https://www.wikibase.consulting/fast-bulk-import-into-wikibase/
- Where to get help?
- 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 user documentation: https://www.mediawiki.org/wiki/Wikibase/Wikibase.cloud
- Telegram for quick help: https://t.me/joinchat/FgqAnxNQYOeAKmyZTIId9g
- Wikibase-cloud mailing list: https://lists.wikimedia.org/postorius/lists/wikibase-cloud.lists.wikimedia.org/