Hjelp:Wikidata liste

Wikidata liste er et forsøk på å beskrive prosessen med å lage en liste eller tabell utfra en spørring mot Wikidata. Det er en lokal hjelpeside for Wikidata som gir en enkel introduksjon til prosjektet, og en mer fullstendig introduksjon på Wikidata-prosjektet.

Bruk rediger

En liste består av to maler; {{Wikidata list}} som innleder lista eller tabellen, og {{Wikidata list end}} som avslutter den. Den siste tar ingen argumenter, men den første tar flere. I tillegg brukes {{Wikidata list documentation}} i toppen av siden hvis lista eller tabellen legges ut på en malside, eller {{Wikidata list menu}} hvis den legges ut på en bruker- eller prosjektside. En Wikidata tabell eller liste bør ikke legges rett i hovedrommet fordi endringer av skribenter overskrives ved oppdatering. Hvis en tabell eller liste kun skal oppdateres automatisk så kan disse malene utelates.

sparql rediger

Den (eller de) viktigste argumentene til Wikidata list er sparql som er selve spørringen, som gjøres via spørrespråket SPARQL. Slike spørringer blir sendt videre til d:Wikidata:SPARQL query service, som har et endepunkt med grafisk grensesnitt. I noen tilfeller kan det være aktuelt å bruke wdq, men det er helst for legacy code. Spørringen genererer et resultatsett, og resten av argumentene til Wikidata list er formatering og utlegg av dette resultatet.

En typisk, men kanskje overforenklet spørring, for å liste norske fylker ser ut som

Brukte elementer: norsk fylke (Q192299)

Brukte egenskaper: forekomst av (P31)

SELECT ?item
WHERE {
  ?item wdt:P31 wd:Q192299 .
}

Prøv!

Alle termer som innleder med et spørsmålstegn er ting vi ikke vet, og som vi ønsker at skal bli fylt ut. For å klargjøre ordningen av disse plasseres de i et SELECT utsagn. Det vi faktisk spør om går i WHERE utsagnet.

I noen tilfeller kan vi ende med en overspesifisert spørring, og da kan vi få et tomt resultatsett. I andre tilfeller kan vi få et enkelt resultat. Det vi som oftest ønsker når vi bruker malverket for en Wikidata liste er at vi skal få et sett av resultater.

Hvis vi prøver å kjøre denne spørringen i endepunktet for SPARQL Query Service så får vi kun Q-identifikatorene, som ikke er så interessant. For å få lesbare etiketter (og beskrivelser) så kan vi endre spørringen noe

Brukte elementer: norsk fylke (Q192299)

Brukte egenskaper: forekomst av (P31)

SELECT ?item ?itemLabel ?itemDescription
WHERE {
  ?item wdt:P31 wd:Q192299 .
  SERVICE wikibase:label { bd:serviceParam wikibase:language "[AUTO_LANGUAGE],en" . }
}

Prøv!

I dette tilfellet har vi lagt til en SERVICE, og dette gjør det mulig å spørre om etikett og beskrivelse selv om dette ikke egentlig er utsagn i elementet. Vi ber også om en tjeneste for etiketten (wikibase:label), men merkelig nok får vi også med beskrivelsen. Ikke helt konsistent! Denne tjenesten filtrerer ut språket slik vi ber om det via content negotiation, eller ved å falle tilbake til engelsk.

Når vi bruker Wikidata list så trenger vi ikke å bruke denne tjenesten, for botten håndterer dette.

De litt merkelige «wd», «wdt», og «wikibase» er navnerom for identifikatorene. Hvert av disse legger på litt forskjellig tolking av identifikatorene. Navnerommet «wd» er for eksempel alle identifikatorer som er definert på Wikidata, mens «wdt» er alle identifikatorer som i tillegg er «truthy». At en egenskap er truthy vil si at det har en definert verdi.

columns rediger

Det nest viktigste argumentet er columns som bestemmer hvilke utsagn som skal tas med fra elementene. Det er flere måter å definere dette, men i første eksempelet vil vi sette opp en mal som

Eksempler rediger

Dette er eksempler som er ment som gode utgangspunkt for videre arbeid

Hjelp:Wikidata liste/Nasjonalparker i Norge

Problemer rediger

Typiske problemer som dukker opp

No items: SPARQL-spørringen genererte ikke noen treff