Mal:Ukens konkurranse kriterium/dok

Dette er en underside med dokumentasjon for Mal:Ukens konkurranse kriterium (se denne siden for selve malen). Den inneholder brukerinformasjon, kategorier og annet som ikke er del av den originale malsiden.

Denne malen brukes av UKBot. Om du gjør endringer i malen må du sørge for at den endrede malen kan leses av boten.

Denne malen benytter seg av Lua:

Modul:UKB

Formål

Malen {{Ukens konkurranse kriterium}} brukes for å definere et kriterium i en konkurranse på en måte som både skal være lesbart både for mennesker (konkurransedeltakerne) og boter som UKBot. Et kriterium kan tenkes på som et artikkelfilter. Alle bidragene til konkurransedeltakerne grupperes etter artikler og sendes gjennom filteret. Deretter blir det regnet poeng for de som går gjennom filteret/filtrene etter poengregler definert med {{Ukens konkurranse poeng}}.

For mer informasjon om hvordan man lager en konkurranseside, se Hjelp:Arrangere konkurranse.

Kriterier

Malens første argument angir hvilket kriterium det er snakk om. Noen kriterier tar flere argumenter.

Hvis malen brukes flere ganger, teller artiklene som oppfylles minst ett av kriteriene (en av malene). Se eksempler under.

Liste over hva som kan gis som første argument (listen kommer nok til å utvides over tid og det er bare å komme med ønsker):

`bytes`

En side er poenggivende hvis den har blitt utvidet med minst et visst antall byte.

{{Ukens konkurranse kriterium | bytes | 1000 }} → utvides med minst 1000 byte

`eksisterende`

En side er poenggivende hvis den ble opprettet før konkurranseperioden.

{{Ukens konkurranse kriterium | eksisterende }} → ble opprettet før konkurransen startet

`enkeltsider`

En side er poenggivende hvis den er listet eksplisitt. Brukes for å direkte liste opp sider som teller med i konkurransen. Kan brukes hvis det ikke finnes en passende kategori. Eksempel:

{{Ukens konkurranse kriterium | enkeltsider | Den arabiske halvøy | nn:Den arabiske halvøya }}

→ Den arabiske halvøy eller Den arabiske halvøya

`fremlenke`

En side er poenggivende hvis den lenker til minst én av de angitte sidene. Omdirigeringer håndteres (i eksempelet under vil det gå fint om artikkelen lenker til FN). Eksempel:

{{Ukens konkurranse kriterium | fremlenke | Forente nasjoner | nn:Dei sameinte nasjonane }}

→ lenker til Forente nasjoner eller Dei sameinte nasjonane

`kategori`

En side er poenggivende hvis den ligger i en bestemt kategori eller underkategori. Boten sjekker kategoritreet på nytt ved hver kjøring, så et bidrag kan gi poeng selv om kategorisering ble gjort etter bidraget ble gjort. På samme måte vil avkategoriseirng føre til at bidrag ikke lenger er poenggivende.

Flere kategorier kan angis adskilt med vertikalstrek. Det holder da at artikkelen ligger i minst én av dem. Du bør ta med minst én kategori per språkprosjekt som er med i konkurransen (typisk bokmål, nynorsk og nordsamisk). Hvis du ikke gjør det vil alle bidrag fra språkprosjekter uten kategorier automatisk aksepteres av kriteriet. Merk at det ikke skal være innledende kolon.

{{Ukens konkurranse kriterium | kategori | Stortingsrepresentanter | nn:Stortingsrepresentantar | se:Stuorradiggeáirasat }}

→ ligger i minst en av kategoriene Stortingsrepresentanter, Stortingsrepresentantar eller Stuorradiggeáirasat

Hvor mange underkategorier som skal sjekkes kan spesifiseres med |maksdybde= (standardverdien er 5, definert i ukfilters.py).^[a] Med |maksdybde=0 må en artikkel ligge direkte i den gitte kategorien. Med |maksdybde=1 kan en artikkel ligge i kategorien eller en av dens underkategorier som Kategori:Ostekake. Eksempel:

{{Ukens konkurranse kriterium | kategori | Kaker | maksdybde=1 }} → ligger i kategorien Kaker

For å utelate bestemte kategorier, bruk |utelat=. Flere kategorier kan skilles med komma. Eksempel:

{{Ukens konkurranse kriterium | kategori | Pattedyr | utelat=Mennesker,Utdødde pattedyr‎ }} → ligger i kategorien Pattedyr

`mal`

En side er poenggivende hvis den er merket med en bestemt mal. Mer spesifikt må siden ha vært merket med malen i foreldrerevisjonen til den første revisjonen gjort av en konkurransedeltaker. Dette innebærer at artikkelen teller også om personen fjerner malen.

{{Ukens konkurranse kriterium | mal |Opprydning}} → merket med {{Opprydning}}

Flere ulike maler kan angis. Det holder da at artikkelen er merket med minst én av de.

{{Ukens konkurranse kriterium | mal |Opprydning|Språkvask}} → merket med {{Opprydning}} eller {{Språkvask}}

Språkprefiks kan benyttes, uten innledende kolon:

{{Ukens konkurranse kriterium | mal |Objektivitet|se:Neutralitehta}} → merket med {{Objektivitet}} eller {{Neutralitehta}}

`navnerom`

En side er poenggivende hvis den ligger i ett av de angitte navnerommene (angis som tall adskilt av vertikal strek). Eksempel:

{{Ukens konkurranse kriterium | navnerom | 0 | 10 }} → er en artikkel eller mal

For å avgrense til ett nettsted:

{{Ukens konkurranse kriterium | navnerom | 0 | 10 | nettsted=www.wikidata.org }} → er en artikkel eller mal på www.wikidata.org

`ny`

En side er poenggivende hvis den er opprettet i løpet av konkurranseperioden (omdirigeringssider er unntatt).

{{Ukens konkurranse kriterium | ny }} → opprettes i løpet av konkurransen

For å inkludere omdirigeringer:

{{Ukens konkurranse kriterium | ny | omdirigeringer=ja }} → opprettes i løpet av konkurransen (inkludert omdirigeringer)

`sparql`

En side er poenggivende hvis den har et Wikidata-element ?item som matcher en SPARQL-spørring

{{Ukens konkurranse kriterium | sparql | spørring=
  {
    ?item wdt:P31/wdt:P279* wd:Q13276 .
  }
  UNION
  {
    ?item wdt:P279* wd:Q13276 .
  }
}}

→ har et wikidata-element som matcher denne SPARQL-spørringen

Det kan være lurt å legge inn en |beskrivelse=, som vises før lenken til spørringen:

{{Ukens konkurranse kriterium | sparql | beskrivelse=om kaker | spørring=
  {
    ?item wdt:P31/wdt:P279* wd:Q13276 .
  }
  UNION
  {
    ?item wdt:P279* wd:Q13276 .
  }
}}

→ om kaker (Wikidata-spørring)

`stubb`

En side er poenggivende hvis et stubbmerke fjernes fra artikkelen. Eksempel:

{{Ukens konkurranse kriterium | stubb }} → nil

`tilbakelenke`

En side er poenggivende den er lenket fra minst én av de angitte sidene (dette kan være en liste utformet i konkurranseøyemed). Omdirigeringer håndteres. Eksempel:

{{Ukens konkurranse kriterium | tilbakelenke | Liste over personer på frimerker fra Gabon }}

→ lenkes fra Liste over personer på frimerker fra Gabon

Overstyre den beskrivende teksten

Hvis den beskrivende teksten malen genererer ikke passer, kan den alltid overstyres med parameteret |beskrivelse=. Eksempel:

{{Ukens konkurranse kriterium | navnerom | 0 | 10 | beskrivelse=hovednavnerommet }}

→ hovednavnerommet

Kombinasjoner av kriterier

Ved kombinasjon av flere kriterier i en konkurranse gjelder følgende:

For kriteriene navnerom, ny og eksisterende gjelder at de alltid må oppfylles.
For andre kriterier gjelder at minst ett av kriteriene må oppfølges

Hvis du f.eks. arrangerer en konkurranse med kriterier ny, kategori og sparql, vil konkurransen inkludere bidrag til nye artikler som ligger i en bestemt kategori eller oppfyller sparql-spørringen (Tenk ny OG (kategori ELLER sparql). Se flere eksempler lenger nede.

Eksempler

Kategorikonkurranse

Merk at konkurransen teller bidrag både på Wikipedia på nynorsk (nnwp) og på bokmål/riksmål (nowp). Det må derfor angis kategorier både på nynorsk og bokmål/riksmål. Hvis kategorien ikke finnes på nowp lenkes den til nnwp, men hvis kategorien skulle ha samme navn begge steder gjør det ingenting – kategorien angis da bare én gang.

Eksempel:

I denne konkurransen teller alle bidrag til artikler som
* {{Ukens konkurranse kriterium | kategori | Byer i Afrika | nn:Byar i Afrika }}

gir

I denne konkurransen teller alle bidrag til artikler som

ligger i minst en av kategoriene Byer i Afrika eller Byar i Afrika

Husk at det kan være nødvendig å sette |maksdybde= for kategorier med mange underkategorinivåer. Dette gjelder for eksempel land.

Tilbakelenke

Merk at for å telle bidrag både på Wikipedia på nynorsk (nnwp) og på bokmål/riksmål (nowp) må det legges inn sider på begge prosjektene. Hvis det eksisterer sider på begge prosjekter med samme navn trengs navnet bare å angis én gang.

Eksempel:

I denne konkurransen teller alle bidrag til artikler som
* {{Ukens konkurranse kriterium | tilbakelenke | Liste over stater | nn:Verdas land }}

gir

I denne konkurransen teller alle bidrag til artikler som

lenkes fra Liste over stater eller Verdas land

Malkonkurranse

Legg merke til at du ikke trenger å oppgi språkprefiks for mal-alias.

Konkurransen går ut på å kildebelegge artikler som er {{Ukens konkurranse kriterium|mal|Kildeløs|Referanseløs|Trenger referanse|nn:Treng kjelde|alias=Tr,Citation needed,Cn,Referanse,Fact,Treng referanse,Kjelde manglar,Manglar kjelde,Mangler kjelde,Referanse manglar,Manglar referanse,Kjelda manglar,Kjelde tarvst,Kjelda tarvst,Tarv kjelde,Referanse tarvst,Referanse trengst,Kjelde trengst,Kjelde manglar,Mangler kilder}}.

gir

Konkurransen går ut på å kildebelegge artikler som er merket med {{Kildeløs}}, {{Referanseløs}}, {{Trenger referanse}} eller {{Treng kjelde}}.

Konkurranse basert på Wikidata-spørring

Eksempel: for å lage en konkurranse om kvinnelige trompetister:

I denne konkurransen teller alle bidrag til artikler som
* {{Ukens konkurranse kriterium | sparql | spørring=SELECT DISTINCT ?item WHERE {
  ?item wdt:P31 wd:Q5 ;
      wdt:P1303 wd:Q8338 ;
      wdt:P21 wd:Q6581072 . }}

gir

I denne konkurransen teller alle bidrag til artikler som

har et wikidata-element som matcher denne SPARQL-spørringen

En liste med bare Q-numre er greit for boten, men upraktisk for brukerne. Man kan derfor legge til f.eks. etiketter eller andre ting – bare pass på at elementet (?item i dette tilfellet) kommer først:

I denne konkurransen teller alle bidrag til artikler som
* {{Ukens konkurranse kriterium | sparql | spørring=SELECT DISTINCT ?item ?itemLabel WHERE {
  ?item wdt:P31 wd:Q5 ;
      wdt:P1303 wd:Q8338 ;
      wdt:P21 wd:Q6581072 . 
  SERVICE wikibase:label { bd:serviceParam wikibase:language "nb,nn,[AUTO_LANGUAGE]". }
}}

Alternativt kan man tilby en egen lenke til VizQuery.

Flere kriterier i samme konkurranse

Hvis man bruker flere kriterier i en konkurranse holder det at en artikkel oppfyller ett av kriteriene. I dette eksempelet tar vi utgangspunkt i et kategori-kriterium, men vi ønsker i tillegg å ha en liste der man kan føre opp bidrag som ikke passer inn i kategorien.

I denne konkurransen teller alle bidrag til artikler som 
{{Ukens konkurranse kriterium |kategori |Kulturminnevern |nn:Kulturminne |}} 
eller {{Ukens konkurranse kriterium | tilbakelenke | Wikipedia:Konkurranser/Ukens konkurranse 2013-49/Liste }}

gir

I denne konkurransen teller alle bidrag til artikler som ligger i minst en av kategoriene Kulturminnevern eller Kulturminne eller lenkes fra Wikipedia:Konkurranser/Ukens konkurranse 2013-49/Liste

Noter

^ Prosesseringstiden skalerer nesten lineært, så det er antakelig ikke noe problem å sjekke 6-7 nivåer om nødvendig. En kan imidlertid få noen «uventede» resultater ved å bruke veldig generelle kategorier. For et eksempel, se denne testen der Kategori:Biologi ble brukt. De fleste treffene er helt greie, men Liste over vinnere av Homofrydprisen er ikke akkurat hva en ville forvente at skulle telle i konkurransen. Årsaken er kategoristien Biologi > Kjønn > LHBT > Vinnere av Homofrydprisen. Det går an å legge inn kategorier boten ikke skal følge i Bruker:UKBot/cat-ignore.

Se også

[1] Prosesseringstiden skalerer nesten lineært, så det er antakelig ikke noe problem å sjekke 6-7 nivåer om nødvendig. En kan imidlertid få noen «uventede» resultater ved å bruke veldig generelle kategorier. For et eksempel, se denne testen der Kategori:Biologi ble brukt. De fleste treffene er helt greie, men Liste over vinnere av Homofrydprisen er ikke akkurat hva en ville forvente at skulle telle i konkurransen. Årsaken er kategoristien Biologi > Kjønn > LHBT > Vinnere av Homofrydprisen. Det går an å legge inn kategorier boten ikke skal følge i Bruker:UKBot/cat-ignore.

[a]