Maldokumentasjon

Formål rediger

Datamal for ListeriaBot.

Bruk rediger

Dette er ikke en ordinær mal, argumentene blir behandlet av en bot, og den må finnes for at botten skal kjøre.

Denne malen definerer en bot-generert tabell basert på Wikidata (opprinneligl blogpost). Den må stenges med {{Wikidata list end}}, og teksten mellom disse to malene vil hvert døgn bli oppdatert av botten. Foreløpig kan det kun lages én liste for hver side, hvis det skal brukes flere lister i en artikkel må de plasseres på separate malsider.

Spørringen inkludere variablen ?item – ikke bytt navn på den!

Eksempel:

{{Wikidata list
|sparql=SELECT ?item WHERE {
   ?item wdt:P31 wd:Q39715 .
   ?item (wdt:P131)* wd:Q55 
  }
|columns=label:Artikkel,description,p131:Sted,P580,P582,p625,P18
|section=P131
|min_section=3
|sort=label
|links=text
|thumb=128
|autolist=fallback
|summary=itemnumber
|wdedit=yes
}}
... (Dette vil bli overskrevet av ListeriaBot) ...
{{Wikidata list end}}

Parametre rediger

sparql
En SPARQL SELECT spørring. Må returnere item nummer i ?item variablen. Du kan bruke et konverteringsverktøy for å gjøre om WDQ til SPARQL, men sjekk alltid din spørring og forsikre deg om at den fungerer, og erstatt "entity:" med "wd:" (phab:T119332).
Se SPARQL spørre-tjenesten for passende eksempler for Listeria.
Påkrevd, hvis ikke wdq er brukt.
wdq
En WikiDataQuery spørring. Resultatet vil bli brukt for å bygge lista. Prøv ut din spørring på AutoList.
Påkrevd, hvis ikke sparql er brukt.
columns
Definerer kolonnene i den genererte tabellen. Gyldige verdier er:
  • number – et serienummer for hver seksjon, løpende fra 1, i henhold til den initielle sorteringen (Brukes for rangering over størrelse, alder, eller lignende)
  • label – etiketten for elementet på wikiens språk, lenket til den lokale artikkelen (hvis den eksisterer), eller Wikidata elementet
  • label/de – etiketten for elementet på angitt språk (her de for tysk) som ren tekst (Brukes for originalspråket eller lignende)
  • description – beskrivelsen for elementet, eller en auto-generert beskrivelse (Brukes om det er stor variasjon mellom elementene)
  • item – elementets Q-identifikator angis i kolonnen (Brukes hovedsakelig for tilleggsfunksjoner)
  • Pxxx, utsagn med Pxxx angis i kolonnen (Eks. p553 (har bruker på nettstedet (P553)) for å hente elementets sosiale medier)
  • Pxxx/Pzzz – utsagn med Pxxx, som har Pzzz som kvalifikator, angis i kolonnen (Eks. p553/p554 (har bruker på nettstedet (P553)/kontonavn på sosialt medium (P554)) for å hente elementets kontonavn på sosiale medier)[note 1]
  • Pxxx/Qyyy/Pzzz – utsagn med Pxxx, som peker på Qyyy og har Pzzz som kvalifikator, angis i kolonnen (Eks. p553/q866/p554 (har bruker på nettstedet (P553)/YouTube (Q866)/kontonavn på sosialt medium (P554)) for å hente elementets kontonavn fra YouTube)
  • ?fieldname – et SPARQL variabelnavn fra resultatet (Brukes der en verdi kan utledes fra elementets utsagn, men ikke finnes som selvstendig utsagn)
Verdier merket som "deprecated" er ikke vist. Hver kolonne kan valgfritt ha en ":Titel", hvis ikke blir egenskapen fra Wikidata brukt.
Påkrevd
sort
Sorteringsnøkkel for tabellen. Gyldige verdier er:
  • label – bruk etiketten til elementet
  • family_name – bruk familienavnet fra etiketten, under antakelse av at dette er siste term i etiketten, som vil feile (Bruk etternavn (P734) hvis mulig)
  • Pxxx – bruk angitt egenskap
section
Seksjonering utfra en Wikidata egenskap.
Valgfri
min_section
Minste antall oppføringer (rader) for å lage en seksjon. Alle andre oppføringer vil bli plassert under "misc".
Standardverdi:2.
Valgfri
autolist
Hvis description er en kolonne, men ingen beskrivelse finnes for elementet, så vil "autolist=fallback" bruke AutoDesc for å lage en.
Valgfri
language
Språk for etikett og beskrivelse, hvis det skal avvike fra lokalt språk på wikien.
Valgfri
thumb
Tommelstørrelsen til bildene (det vil si kolonnen som bruker ,egenskapen P18).
Standardverdi:128.
Valgfri
links
Hvordan lenker vises når de ikke er på den lokale wikien. Gyldige verdier er:
  • all – lager lenker til Wikidata ved behov. Standardverdi.
  • local – fjerner lenking når det ikke finnes lokal artikkel.
  • red – lager rødlenke basert på etiketten og elementet.
  • text – lager blålenke til eksisterende sider, og tekst for resten.
  • reasonator – lager blålenke til eksisterende side, og lenker til Reasonator for resten.
Valgfri
row_template
Lager et malkall istedenfor en tabellrad, malen må lage en fullstendig tabellrad. Parametrene gitt til malen bruker små bokstaver fra columns parameteren, det vil si label eller p18.
Valgfri
header_template
Genererer et malkall istedenfor en auto-generert tabell-topp. Malen må selv generere en tabell-topp. Ingen parametre gis til malen. Anbefalt brukt sammen med row_template.
Valgfri
skip_table
Undertrykk generering av tabell-markup fullstendig når row_template brukes. Enhver verdi fungerer.
wdedit
Generer informasjon som vil tillate redigering av Wikidata fra Wikipedia ved å bruke en tilleggsfunksjon. (Scriptet har feil.) Verdien må være yes. Fungerer ikke når row_template brukes.
Advarsel: Dette vil generere mer wikitekst enn normalt, og oppdatering kan feile.
Valgfri
references
Generer referanser. Verdien må være all. En referanseseksjon må settes opp manuelt.
Valgfri
freq
Numerisk verdi for minimum antall dager siden siste automatiske oppdatering. Påvirker ikke oppdateringer via nettsiden.
Valgfri
summary
Komma-separert liste av nøkler som legges ved som et sammendrag under alt annet innhold.
Valgfri
  • itemnumber – totalt antall elementer (rader) i resultatet.
short
Alle verdier kontrollerer at spørringen ikke blir vist.
Valgfri

TemplateData rediger

Dette er TemplateData-dokumentasjonen for malen, som brukes av VisualEditor og andre verktøy.

Wikidata list

Datamal for ListeriaBot. Malen skal ikke brukes i hovedrommet! Bruk en egen mal for tabellen/lista.

Malparametre[Rediger maldata]

Denne malen foretrekker at parametrene blokk-formateres (én parameter per linje).

ParameterBeskrivelseTypeStatus
SPARQLsparql

En SPARQL SELECT spørring. Påkrevd hvis ikke WDQ er brukt.

Innholdvalgfri
WDQwdq

En WikiDataQuery spørring. Påkrevd hvis ikke SPARQL er brukt.

Innholdvalgfri
Kolonnercolumns

Definerer kolonnene i den genererte tabellen.

Innholdpåkrevd
Sorteringsort

Sorteringsnøkkel for tabellen.

tekstlinjevalgfri
Seksjonsection

Seksjonering utfra en Wikidata egenskap.

tekstlinjevalgfri
Min seksjonmin_section

Minste antall oppføringer (rader) for å lage en seksjon.

Standard
2
Tallvalgfri
Autolistautolist

Hvis description er en kolonne og mangler beskrivelse så vil AutoDesc brukes for å lage en.

tekstlinjevalgfri
Språklanguage

Språk for etikett og beskrivelse, hvis det skal avvike fra lokalt språk på wikien.

tekstlinjevalgfri
Tommelthumb

Bredden på tommelvisning (e.g. kolonnen for P18).

Standard
128
Tallvalgfri
Lenkerlinks

Hvordan lenker skal lages i den lokale wikien.

tekstlinjevalgfri
Radmalrow_template

Lager et malkall istedenfor en tabellrad, malen må lage en fullstendig tabellrad.

Innholdvalgfri
Headermalheader_template

Genererer et malkall istedenfor en auto-generert tabell-topp.

Innholdvalgfri
Skip tableskip_table

Undertrykk generering av tabell-markup fullstendig når row_template brukes.

tekstlinjevalgfri
Wd editwdedit

Generer informasjon som vil tillate redigering av Wikidata fra Wikipedia ved å bruke en tilleggsfunksjon.

tekstlinjevalgfri
Referanserreferences

Genererer referanser som plasseres i den ordinære referanse-seksjonen.

tekstlinjevalgfri
Frekvensfreq

Numerisk verdi for minimum antall dager siden siste automatiske oppdatering.

Tallvalgfri
Sammendragsummary

Komma-separert liste av nøkler som legges ved som et sammendrag under alt annet innhold.

tekstlinjevalgfri
Kortshort

Alle verdier kontrollerer at spørringen ikke blir vist.

tekstlinjevalgfri

Eksempel rediger

{{Wikidata list
 |sparql=SELECT ?item WHERE { ?item wdt:P31 wd:Q39715 .  ?item wdt:P131 ?sub0 .  ?sub0 (wdt:P131)* wd:Q55 }
 |wdq=claim[31:39715] and claim[131:(tree[55][][131])]
 |section=131
 |sort=label
 |columns=label:Article,description,p131:Place,P580,P582,p625,P18
 |thumb=128
 |min_section=2
 |language=nb
}}
...
{{tl|Wikidata list end}}

Se også rediger

Noter rediger

  1. ^ Dette er bare delvis implementert, og fungerer kun når kvalifikator viser til en verdi. Hvis den viser til et annet element så vil det dukke opp «QArray» i kolonnen. Det er en intern representasjon av en Q-id.