Mal:Wikidata-norsk: Forskjell mellom sideversjoner

Sideversjonen fra 25. apr. 2019 kl. 16:24

Maldokumentasjon

[vis] [rediger] [historikk] [gjenoppfrisk]

Denne malen brukes på mer enn 150 000 sider.
Det anbefales at endringer testes i en sandkasse før de legges inn. Diskuter gjerne også endringer på diskusjonssiden først.

Denne malen benytter seg av Lua:

Modul:Wd-norsk

Denne malen er beregnet til å hente data fra Wikidata med og uten å implementeres i artikkelen dataen skal hentes fra. Den inneholder også en rekke andre funksjoner.

Malen er basert på Wikidata (enwiki) men er tilpasset for nowiki.

Bruk

{{Wikidata-norsk |kommando1|flagg1a|flagg1b|flagg1c |kommando2|flagg2a|flagg2b|flagg2c |flagg0a|flagg0b|flagg0c |arg1|arg2|arg3

Kommandoer

Kommandoene (kommando1, kommando2, ...) avgjør hvilke verdier som blir hentet. Kommandoer fra Hente-gruppen og Den generelle gruppen kan ikke brukes i lag.

Hente-gruppen

Hente-gruppens kommandoer kan kombineres, det betyr at du kan bruke flere fra denne gruppen samtidig.

Vennligst bruk muligheten til å bruke flere kommandoer samtidig når det passer seg, isteden for å bruke flere mindre bruk av malen. Det sørger for at all informasjonen som hører sammen kommer i lag.

Type	Kommando	Returnerer	Grunnleggende bruk	Beskrivelse
I	`egenskap`	første treff^{[lower-alpha 1]}	`{{Wikidata-norsk\|egenskap\|P1}}`	Returnerer den etterspurte egenskapen – eller en liste av egenskaper – fra artikkelen malen er implementert i eller fra gitt ID.
I	`egenskaper`	alle treff	`{{Wikidata-norsk\|egenskaper\|P1}}`

II	`kvalifikator`	første treff^{[lower-alpha 1]}	`{{Wikidata-norsk\|kvalifikator\|P1\|P2}}`	Returnerer etterspurt kvalifikator – eller en liste med kvalifikatorer – fra artikkelen malen er implementert i eller fra gitt ID. I motsetning til de andre hente gruppen kommandoene, kan denne bli gitt flere ID-er for å hente mer informasjon.
II	`kvalifikatorer`	alle treff	`{{Wikidata-norsk\|kvalifikatorer\|P1\|P2}}`

III	`referanse`	første treff^{[lower-alpha 1]}	`{{Wikidata-norsk\|referanse\|P1}}`	Returnerer en referanse – eller en liste med referanser – fra artikkelen malen er implementert i eller fra gitt ID.^{[lower-alpha 2]}
III	`referanser`	alle treff	`{{Wikidata-norsk\|referanser\|P1}}`

Type nummerering ↑ ^1,0 ^1,1 ^1,2 Returnerer kun en enkel verdi isteden for flere (hvis flere verdier eller søk stemmer). Det som returneres er den første som er funnet som er rangert best ↑ Bare kilder som er gyldig i forhold til Wikidata rettningslinjer på kilder blir returnert (f.eks. de som minst har en verdi d:P248 eller d:P854.

Den generelle gruppen

Den generelle gruppens kommandoer kan ikke bli kombinert med hverandre.

Type	Kommando	Returnerer	Grunnleggende bruk	Beskrivelse
I	`etikett`		`{{Wikidata-norsk\|etikett}}`	Returnerer etiketten til artikkelen malen brukes i eller til en gitt ID.

II	`tittel`		`{{Wikidata-norsk\|tittel}}`	Returnerer tittel til artikkelen malen brukes i eller til en gitt ID.

III	`beskrivelse`		`{{Wikidata-norsk\|beskrivelse}}`	Returnerer beskrivelse til artikkelen malen brukes i eller til en gitt ID.

IV	`alias`	første treff^{[lower-alpha 1]}	`{{Wikidata-norsk\|alias}}`	Returnerer et alias – eller en liste av aliaser – til artikkelen malen brukes i eller til en gitt ID.
IV	`aliaser`	alle treff	`{{Wikidata-norsk\|aliaser}}`

V	`merke`	første treff^{[lower-alpha 1]}	`{{Wikidata-norsk\|merke}}`	NB! Merke og Merker funker ikke for øyeblikket Returnerer et merke – eller liste av merker – til artikkelen malen brukes i eller til en gitt ID.
V	`merker`	alle treff	`{{Wikidata-norsk\|merker}}`

Type nummerering ↑ ^1,0 ^1,1 Returnerer kun en enkel verdi isteden for flere (hvis flere verdier eller søk stemmer).

Flagg

Følgende (valgfrie) flagg er tilgjengelig for å kunne endre denne malens adferd. De må bli gitt etter den første kommando og før andre argumenter. For enkelhetens skyld er tomme flagg (f.eks. ||) tiltatt og vil simpelthen bli ignorert.

Kommandoflagg

Disse flaggene (flag1*, flag2*, ...) gjelder den første kommandoen som er foran dem.

Flagg	Forklaring
`linket`	Oppretter en link til Wikipedia-artikkelen som er koblet til egenskap eller kvalifikator hvis en artikkel eksisterer. Den linker også måleenheter som kan være vedlagt verdier. Hvis dette flagget er utelatt, vil egenskapen eller kvalifikatoren hentes med som ren tekst.
`kortnavn`	`[RESSURSKREVENDE]` Den returnerer kortnavn (P1813) av uansett verdi så lenge den har et kortnavn. Hvis den ikke har et kortnavn vil den hente verdien som normalt.
`rå`	Returnere råverdien hvis mulig. Hvis flagget er brukt med en artikkel eller egenskap datatype vil den hente Q-IDen eller P-IDen. For kvalifikator datatyper vil flagget fjerne alle måleenheter, med mindre `måleenhet` flagget også er inkluder hvor den da vil hente måleenhetens Q-ID. Hvis flagget er brukt med dato datatype vil datoen hentes i formatet `åååå-mm-dd` (f.eks. `1731-02-11`, eller `åååå-mm` eller `åååå` avhengig av datoens presisjon hos Wikidata. Datoer i den julianske kalenderen lagret med en presisjon med dager gjennom millennium vil ha `/Julian` lagt til resultat (f.eks. `1731-02-11/Julian`, som kan bli splittet av med å bruke {{#titleparts}} mal funksjon). Hvis det er brukt med globe koordinater datatype vil den fjerne diverse symboler med fremover skråstrek i den hentet verdien (f.eks. `52/5/3/N/4/19/3/E`, som kan bli splittet i mindre deler med {{#titleparts}} mal funksjon).
`flerspråklig`	Henter teksten i uansett tilgjengelig språk, ikke bare norsk.
`måleenhet`	Henter bare måleenheten for mengde datatyper.

Konfigurasjonsflagg

Disse flaggene (flag0*) er generelle konfigurasjonsflagg og kan bli gitt når som helst etter første kommando (men før de andre argumenter).

	Flagg	Kommando gruppe	Beskrivelse
Kombinasjon av:	`foretrukket`	hente	Setter en rang begrensing for de valgte resultat(ene). De første tre setter rang etter hvilket resultat(er) vil bli valgt. De kan alternativt bli fulgt med `+` eller `-`, f.eks. `normal+` eller `foretrukket-`, hvor den første velger resultater med 'normal' rang eller høyere og den andre velger resultater med 'foretrukket' rang eller lavere. For å få resultater fra alle rangene bruk `foretrukket-` eller `avskrevet+` Hvis `best` flagg er brukt vil det eneste resultatet som valgt den med høyest rank av alle resultatene bli valgt. Det vanlige er `normal+\|best` (så standard er resultatene med 'avskrevet' rang aldri hentet). Resultatet vil alltid bli sorter fra høyest rang til lavest (uavhengig av at noen av disse flaggene blir brukt).
	`normal`
	`avskrevet`
	`best`
Kombinasjon av:	`fremtid`	hente	Setter en tidsbegrensing for resultantet. Den anvender kvalifikatorene startdato (P580) og sluttdato (P482) for å avgjøre den riktige valgte perioden. Det vanlige er `fremtid\|nåværende\|tidligere` (så standarden er resultat er gyldig for hvilket som helst tidsperiode).
	`nåværende`
	`tidligere`
	`mdå`	hente	Henter datoen i måned-dag-år rekkefølge istdenfor dag-måned-år rekkefølgen.
	`enkel`	hente	Henter bare en enkel resultat istedenfor mange (hvis det er flere treff). Den har ingen effekt på `egenskap`/`egenskaper` kommando som er gitt, i gitt tilfelle vil flagge være unødvendig.
	`referert`	hente	Henter kun verdier som har minst en gyldig referanse.
En av:	`rediger`	hente, generell	Legger til en klikkbart ikon som leder til Wikidata hvor leser har mulighet til å redigere informasjonen. Hvis `redigerpåslutten` er brukt, vil ikonet plasseres på slutten av linjen for fine infobokser.
En av:	`redigerpåslutten`	hente, generell

Argumenter

Argumentene avgjør kilden fra hvor alle verdier blir hentet fra.

Posisjonelle argumenter

Denne tabellen viser de tilgjengelige posisjonelle argumentene (arg*) i fastsatt rekkefølge. For hver kommando er det aktuelle argumentet markert. Hvis flere kommandoer er gitt, er gjeldene sett forenelig med de mindre settene. For eksempel, hvis kommandoene egenskaper og kvalifikatorer er gittn skal minimum begge argumentene egenskap_id og kvalifikator_id bli gitt.

Mer enn én kvalifikator/kvalifikatorer kommandoer kan bli gitt. Rekkefølgen av de gitte kommandoene og deres flagg gir samme rekkefølgen som hvordan de respektive kvalifiaktor_id argumentene gis.

	(påkrevd)	(valgfri)	(valgfri)	(påkrevd)	(valgfri)	(påkrevd)	(påkrevd)

`{{Wikidata-norsk`	`kommandoer`	`flagg`	`artikkel_id`	`egenskap_id`	`rå_verdi`	`kvalifikator_id`	`kvalifikator_id`	`}}`

			`etikett`, `tittel`, `beskrivelse`, `alias`/`aliaser`, `merke`/`merker`

			`egenskap`/`egenskaper`
			`egenskap`/`egenskaper`
			`referanse`/`referanser`
			`referanse`/`referanser`
			`kvalifikator`/`kvalifikatorer`
			`kvalifikator`/`kvalifikatorer`
			`kvalifikator`/`kvalifikatorer` (valgfri 2., 3., osv.)
			`kvalifikator`/`kvalifikatorer` (valgfri 2., 3., osv.)

Under er beskrivelse av alle posisjonelle argumenter.

Argument	Beskrivelse
`artikkel_id` (valgfri)	`[RESSURSKREVENDE]`Q-ID til artikkelen som skal hentet (f.eks. `Q20`), eller P-ID (eller en tilgjengelig alias) av egenskap-verdien som skal bli hentet av `Egenskap:` prefiks (f.eks. `Egenskap:P38`). I forhold til den generelle kommando-gruppen, kan `Egenskap:` prefiksen bli droppet for P-ID (f.eks. `P38`). Hvis denne parameteren ikke er brukt vil artikkel ID koblet til siden hvor malen brukes (ved untakt hvis `eid=` er i bruk, mer info under). Hvis denne parameteren er gitt men er tom (f.eks. `\|\|`), vil den på grunn av sin plassering blir sett på som et tomt flagg og dermed bli ignorert, og gi samme resultat som om parameteren ikke hadde vært brukt. Se også `eid=` navngitte argumenter under som også kan brukes til å gi en artikkel ID, men uten at at artikkel ID koblet til siden malen anvendes i.
`egenskaps_id`	P-ID (eller en tilgjengelig alias) av egenskapen i artikkelen som skal bli hentet uten `Egenskap:` prefiksen (f.eks. `P35`).
`rå_verdi` (optional)	Enten Q-ID lik til egenskaps verdien (f.eks. `Q29574`) eller en bokstavelig verdi (som streng eller mengde osv., ingen etikett er gyldig) som er lik den rå egenskap verdien av det som skal hentes. Datoer som bokstavelig verdi må bli formatert `åååå-mm-dd` (f.eks. `1731-02-11` for datoer med nøyaktighetsnivå til dager, `åååå-mm` (f.eks. `1731-02`) for datoer med presisjon til måneder, og `åååå` (f.eks. `1731` for datoer med lavere nøyaktighet. Datoer f.Kr. krever et minustegn foran årstallet (f.eks. `-29500-01-31`). Datoer lagret i den julianske kalenderen må ha `/Julian` lagt til på slutten (f.eks. `1731-02-11/Julian`). Tiår som 2010-tallet må bli gitt som `2010` (men 2010-tallet f.Kr. som `-2019`, århundre som 20. århundre som `1901` (men som 20. århundre f.Kr. `-2000`, og for årtusener som den 3. årtusen som `2001` (men 3. årtusen f.Kr. som `-3000`. Globe koordinater som bokstavelig verdi må bli formater med fremover skråstreker (f.eks. `/`) mellom delene og ingen symboler (f.eks. `52/5/3/N/4/19/3/E`) uten noen mellomrom eller ledene null. Den spesielle typen 'no value' kan bli gitt med å bruke en tom streng (slik `\|\|`) og den spesielle typen 'unknown value' kan bli gitt med å legge inn en enkel understrek (slik `\|_\|`). For å få faktisk understrek sett en bakover skråstrek `\` direkte forran (slik `\_`, det samme gjelder for faktiske bakover skråstreker (slik `\\`. For å få en faktisk loddrett strek `\|`, bruk `{{!}}` eller `\|`. Hvis denne parameteren er utelatt vil alle søk (møter alle andre krav) innen egenskapen bli hentet.
`kvalifikator_id`	P-ID (eller en tilgjengelig alias) av egenskapen i artikkelen som skal bli hentet uten `Egenskap:` prefiksen (f.eks. `P580`).

Navngitte argumenter

Under er en tabell med beskrivelser av alle navngitte argumenter som er kommandoer som brukes |navn=verdi. Disse er alle valgfrie og kan bli brukt hvor som helst i malen.

Argument	Beskrivelse
`eid=`	`[RESSURSKREVENDE]` Dette argumentet tilbyr funksjonalitet som posisjonelle argumenter `artikkel_id` (f.eks. `>\|eid=Q55`), med en forskjell: hvis argumentet er gitt men er blitt stående tom (`\|eid=`) vil ingen artikkel bli hentet. Dette er nyttig hvor en artikkel_id er forventet, men hvor sidens artikkel ikke skal bli brukt som standard. Også `Egenskap:` prefiksen kan bli utelatt for P-ID (f.eks. `\|eid=P38`) for alle kommandoer. Dette argument har bare effekt hvis det posisjonelle argumentet `artikkel_id` er utelatt.
`<kvalifikator>=`	`<kvalifikator>` er en plassholder for sett med argumenter for å avgjøre hvilket resultat som skal bli hentet basert på kvalifikatorverdi, den benytter seg av Posisjonelle argumentene `egenskaps_id` og `rå_verdi` for å avgjøre hvilken resultater den skal hente. `<kvalifikator>` er hvilken som helst kvalifikator P-ID (eller en tilgjengelig alias) uten bruk av `Egenskap:` prefiksen (f.eks. `P518`). Dens verdi er enten Q-verdi lik en av kvalifikatorens verdier (f.eks. `Q27561` eller en bokstavelig verdi(som streng eller menge osv., igen etiketter kan brukes) lik råverdien til kvalifikatorens verdier til resultatet. Verdiformater er det samme som det posisjonelle argumentet `rå_verdi`. Den spesielle verditypen 'no value' er gitt med en tom streng vil også gi resultater som totalt mangler den verdien i kvalifikatoren. Eksempel: `\|P512=Q27561` Flere argumenter av denne typen kan brukes til å sammenligne flere kvalifikatorverdier samtidig.

Egenskap aliaser

Egenskap aliaser er alternative navn for P-ID og kan bli benyttet istedet. Følgende aliaser skiller mellom store og små bokstaver.

Alias	P-ID
coord	P625

image	P18
author	P50
publisher	P123
importedFrom	P143
statedIn	P248
pages	P304
language	P407
publicationDate	P577
startTime	P580
endTime	P582
chapter	P792
retrieved	P813
referenceURL	P854
sectionVerseOrParagraph	P958
archiveURL	P1065
title	P1476
formatterURL	P1630
quote	P1683
shortName	P1813
archiveDate	P2960
inferredFrom	P3452
typeOfReference	P3865
column	P3903

Avansert bruk

Oppsettet av resultatet fra kommando(er) som både har en enkel og flere resultater (f.eks. egenskap/egenskaper) kan bli tilpasset med å bruke forskjellige navngitte flagg (|flagg=verdi), som kan brukers hvor som helst i malen. Tabellen under viser de tilgjengelige flaggene.

For å sette inn et mellomrom i starten eller slutten av verdi, bruke en understrek _. For å få en faktisk understrek plasser man en bakover skråstrek \ direkte foran (slik \_), det samme gjelder for faktiske bakover skråstrek (f.eks. \\). For å få en rett strek |, bruk {{!}} eller |.

Navngitt flagg Standard verdi Standard krav Beskrivelse

format=

%p[%s][%r]

hvis egenskap/egenskaper kommando var brukt og kvalifikator/kvalifikatorer kommando var ikke gitt

Formatet for et enkel resultat. De tilgjengelige parametre er som følger:

Parameter	Beskrivelse
`%p`	Resultatet hentet av `egenskap`/`egenskaper` kommando.
`%q1`, `%q2`, `%q3`, ...	Resultatet hentet av kvalifikator verdi eller liste med kvalifikator verdier `kvalifikator`/`kvalifikatorer` kommando.
`%q`	Sammlingen av alle kvalifikator verdier fra `kvalifikator`/`kvalifikatorer` kommando (som `%q1` + `%q2` + `%q3` + ...). Hvis bare en `kvalifikator`/`kvalifikatorer` kommando var gitt er denne kommandoen det samme som `%q1`.
`%r`	Den hentet referansen eller listen av referater hentet av `referanse`/`referanser` kommando.
`%a`	Artikkelen alias eller aliaser hentet av `alias`/`aliaser` kommando.
`%b`	Artikkelens merke eller merker hentet av `merke`/`merker` kommando.
`%s`	En flyttbare plassholderseparator. Dette er en spesiell kommando som ikke blir brukt av en kommando, men istedet plassert mellom hvert resultat (gitt en liste med resultater). Dette er også praktisk når referanser hentes, siden det gir muligheten til at referansen blir plassert etter punktum. Standardverdien er (`,`) men den kan bli overstyrt med `sep%s`-flagget (se nedenfor).

Valgfrie parameter kan bli gitt ved å pakke dem inn i klammeparenteser: [...]. Alt innholdet mellom klammeparentesen vil bare bli vist hvis en verdi for hver valgfri parameter mellom klammeparentes eksisterer. Valgfritt innhold kan også bli gruppert.

Minst en parameter må bli gitt som ikke er valgfri, mens %s parametere må alltid være satt som valgfri.

For å bokstavelig få [, ], % eller \, plasser en bakover skråstrek \ direkte foran tegnet (f.eks. \%). Se også beskrivelsen rett over denne tabellen for mer informasjon.

%q[%s][%r] hvis egenskap/egenskaper kommando ikke var brukt og kvalifikator/kvalifikatorer kommando var gitt

%r hvis bare referanse/referanser kommandoen var gitt

%p[ <span style="font-size:85\%">(%q)</span>][%s][%r] hvis egenskap/egenskaper kommando var brukt og kvalifikator/kvalifikatorer kommando var gitt

%a[%s] hvis alias/aliaser kommando var gitt

%b[%s] hvis merke/merker kommando var gitt

sep= standard Den satte separatoren mellom vært par av resultater.

hvis bare referanse/referanser kommando har blitt gitt uten rå flagg

sep%s= , standard Den flyttbare separatoren mellom hvert resultat. Dette vil være verdien av %s parameter vil gjelde alle resultater ved unntak av den siste i listen.

; hvis egenskap/egenskaper kommando ikke var brukt og kvalifikator/kvalifikatorer kommando var gitt

sep%q1=, sep%q2=, sep%q3=, ...

,

standard

Separatoren mellom resultater av kvalifikatorer fra et søk. Disse verdiene er separatoren for %q1, %q2, %q3, ... parameterne.

Hvis bare en kvalifikator/kvalifikatorer kommando var gitt er sep%q1 flagget det samme som sep%q.

sep%q=

,

hvis nøyaktig en kvalifikator/kvalifikatorer kommando var gitt

Separatoren mellom resultater av kvalifikatorer fra et søk. Disse verdiene er separatoren for %q parameterne.

Hvis bare en kvalifikator/kvalifikatorer kommando var gitt er sep%q1.

; hvis mer enn en kvalifikator/kvalifikatorer kommando var gitt

sep%r= standard Separatoren mellom hver referanse av et enkelt søk. Dette er separatoren for %r parametere.

hvis rå flagget var gitt for referanse/referanser kommando

punc=