Redigerer Mal:Ukens konkurranse kriterium/dok

{{Dokumentasjonsunderside}}
{{Tmbox |image=[[Fil:Crystal Clear action run.svg|50px|Bot]] |text=Denne malen brukes av [[Bruker:UKBot|UKBot]]. Om du gjør endringer i malen må du sørge for at den endrede malen kan leses av boten.}}
<!-- LEGG TIL KATEGORIER OG INTERWIKIER PÅ BUNNEN AV DENNE SIDEN -->
{{Lua|Modul:UKB}}
== Formål ==

Malen {{ml|Ukens konkurranse kriterium}} brukes for å definere et kriterium i [[WP:Konkurranser|en konkurranse]] på en måte som både skal være lesbart både for mennesker (konkurransedeltakerne) og boter som [[Bruker:UKBot|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 {{ml|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):

=== <code>bytes</code> ===

En side er poenggivende hvis den har blitt utvidet med minst et visst antall byte.
: <code><nowiki>{{Ukens konkurranse kriterium | bytes | 1000 }}</nowiki></code> → {{Ukens konkurranse kriterium | bytes | 1000 }}

=== <code>eksisterende</code> ===

En side er poenggivende hvis den ble opprettet før konkurranseperioden.
: <code><nowiki>{{Ukens konkurranse kriterium | eksisterende }}</nowiki></code> → {{Ukens konkurranse kriterium | eksisterende }}

=== <code>enkeltsider</code> ===

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:
: <code><nowiki>{{Ukens konkurranse kriterium | enkeltsider | Den arabiske halvøy | nn:Den arabiske halvøya }}</nowiki></code>
: → {{Ukens konkurranse kriterium | enkeltsider | Den arabiske halvøy | nn:Den arabiske halvøya }}

=== <code>fremlenke</code> ===

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:
: <code><nowiki>{{Ukens konkurranse kriterium | fremlenke | Forente nasjoner | nn:Dei sameinte nasjonane }}</nowiki></code>
: → {{Ukens konkurranse kriterium | fremlenke | Forente nasjoner | nn:Dei sameinte nasjonane }}

=== <code>kategori</code> ===

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.
: <code><nowiki>{{Ukens konkurranse kriterium | kategori | Stortingsrepresentanter | nn:Stortingsrepresentantar | se:Stuorradiggeáirasat }}</nowiki></code>
: → {{Ukens konkurranse kriterium |kategori | Stortingsrepresentanter | nn:Stortingsrepresentantar | se:Stuorradiggeáirasat }}
Hvor mange underkategorier som skal sjekkes kan spesifiseres med <code><nowiki>|maksdybde=</nowiki></code> ('''standardverdien er 5''', definert i [//github.com/danmichaelo/UKBot/blob/master/bot/ukfilters.py#L137 ukfilters.py]).<ref group=lower-alpha>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 [http://no.wikipedia.org/w/index.php?title=Bruker:Danmichaelo/Sandkasse7&oldid=10816444 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 &gt; Kjønn &gt; LHBT &gt; Vinnere av Homofrydprisen. Det går an å legge inn kategorier boten ikke skal følge i [[Bruker:UKBot/cat-ignore]].</ref> Med <code><nowiki>|maksdybde=0</nowiki></code> må en artikkel ligge direkte i den gitte kategorien. Med <code><nowiki>|maksdybde=1</nowiki></code> kan en artikkel ligge i kategorien eller en av dens underkategorier som [[:Kategori:Ostekake]]. Eksempel:
: <code><nowiki>{{Ukens konkurranse kriterium | kategori | Kaker | maksdybde=1 }}</nowiki></code> → {{Ukens konkurranse kriterium | kategori | Kaker | maksdybde=1 }}
For å utelate bestemte kategorier, bruk {{para|utelat}}. Flere kategorier kan skilles med komma. Eksempel:
: <code><nowiki>{{Ukens konkurranse kriterium | kategori | Pattedyr | utelat=Mennesker,Utdødde pattedyr‎ }}</nowiki></code> → {{Ukens konkurranse kriterium | kategori | Pattedyr | utelat=Mennesker,Utdødde pattedyr‎ }}

=== <code>mal</code> ===

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.
: <code><nowiki>{{Ukens konkurranse kriterium | mal |Opprydning}}</nowiki></code> → {{Ukens konkurranse kriterium | mal |Opprydning}}
Flere ulike maler kan angis. Det holder da at artikkelen er merket med ''minst én'' av de.
: <code><nowiki>{{Ukens konkurranse kriterium | mal |Opprydning|Språkvask}}</nowiki></code> → {{Ukens konkurranse kriterium | mal |Opprydning|Språkvask}}
Språkprefiks kan benyttes, uten innledende kolon:
: <code><nowiki>{{Ukens konkurranse kriterium | mal |Objektivitet|se:Neutralitehta}}</nowiki></code> → {{Ukens konkurranse kriterium | mal |Objektivitet|se:Neutralitehta}}

=== <code>navnerom</code> ===

En side er poenggivende hvis den ligger i ett av de angitte navnerommene (angis som tall adskilt av vertikal strek). Eksempel:
: <code><nowiki>{{Ukens konkurranse kriterium | navnerom | 0 | 10 }}</nowiki></code> → {{Ukens konkurranse kriterium | navnerom | 0 | 10 }}
For å avgrense til ett nettsted:
: <code><nowiki>{{Ukens konkurranse kriterium | navnerom | 0 | 10 | nettsted=www.wikidata.org }}</nowiki></code> → {{Ukens konkurranse kriterium | navnerom | 0 | 10 | nettsted=www.wikidata.org }}

=== <code>ny</code> ===

En side er poenggivende hvis den er opprettet i løpet av konkurranseperioden (omdirigeringssider er unntatt).
: <code><nowiki>{{Ukens konkurranse kriterium | ny }}</nowiki></code> → {{Ukens konkurranse kriterium | ny }}
For å inkludere omdirigeringer:
: <code><nowiki>{{Ukens konkurranse kriterium | ny | omdirigeringer=ja }}</nowiki></code> → {{Ukens konkurranse kriterium | ny | omdirigeringer=ja }}

=== <code>sparql</code> ===

En side er poenggivende hvis den har et Wikidata-element <code>?item</code> som matcher en SPARQL-spørring
: <code><nowiki>{{Ukens konkurranse kriterium | sparql | spørring=
  {
    ?item wdt:P31/wdt:P279* wd:Q13276 .
  }
  UNION
  {
    ?item wdt:P279* wd:Q13276 .
  }
}}</nowiki></code> → {{Ukens konkurranse kriterium | sparql | spørring=
  {
    ?item wdt:P31/wdt:P279* wd:Q13276 .
  }
  UNION
  {
    ?item wdt:P279* wd:Q13276 .
  }
}}
Det kan være lurt å legge inn en {{para|beskrivelse}}, som vises før lenken til spørringen:
: <code><nowiki>{{Ukens konkurranse kriterium | sparql | beskrivelse=om kaker | spørring=
  {
    ?item wdt:P31/wdt:P279* wd:Q13276 .
  }
  UNION
  {
    ?item wdt:P279* wd:Q13276 .
  }
}}</nowiki></code> → {{Ukens konkurranse kriterium | sparql | beskrivelse=om kaker | spørring=
  {
    ?item wdt:P31/wdt:P279* wd:Q13276 .
  }
  UNION
  {
    ?item wdt:P279* wd:Q13276 .
  }
}}

=== <code>stubb</code> ===

En side er poenggivende hvis et stubbmerke fjernes fra artikkelen. Eksempel:
: <code><nowiki>{{Ukens konkurranse kriterium | stubb }}</nowiki></code> → {{Ukens konkurranse kriterium | stubb }}

=== <code>tilbakelenke</code> ===

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:
:<code><nowiki>{{Ukens konkurranse kriterium | tilbakelenke | Liste over personer på frimerker fra Gabon }}</nowiki></code>
: → {{Ukens konkurranse kriterium | tilbakelenke | 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 {{para|beskrivelse}}. Eksempel:

<code><nowiki>{{Ukens konkurranse kriterium | navnerom | 0 | 10 | beskrivelse=hovednavnerommet }}</nowiki></code>
:: → {{Ukens konkurranse kriterium | navnerom | 0 | 10 | beskrivelse=hovednavnerommet }}

== Kombinasjoner av kriterier ==

Ved kombinasjon av flere kriterier i en konkurranse gjelder følgende:
* For kriteriene <code>navnerom</code>, <code>ny</code> og <code>eksisterende</code> 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 <code>ny</code>, <code>kategori</code> og <code>sparql</code>, vil konkurransen inkludere bidrag til nye artikler som ligger i en bestemt kategori eller oppfyller sparql-spørringen (Tenk <code>ny OG (kategori ELLER sparql</code>). 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:
<blockquote>
<pre>
I denne konkurransen teller alle bidrag til artikler som
* {{Ukens konkurranse kriterium | kategori | Byer i Afrika | nn:Byar i Afrika }}
</pre>
</blockquote>
gir
<blockquote style="border:1px solid #ccc; padding:10px;">
I denne konkurransen teller alle bidrag til artikler som
* {{Ukens konkurranse kriterium | kategori | Byer i Afrika | nn:Byar i Afrika }}
</blockquote>
Husk at det kan være nødvendig å sette {{para|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:
<blockquote>
<pre>
I denne konkurransen teller alle bidrag til artikler som
* {{Ukens konkurranse kriterium | tilbakelenke | Liste over stater | nn:Verdas land }}
</pre>
</blockquote>
gir
<blockquote style="border:1px solid #ccc; padding:10px;">
I denne konkurransen teller alle bidrag til artikler som
* {{Ukens konkurranse kriterium | tilbakelenke | Liste over stater | nn:Verdas land }}
</blockquote>

=== Malkonkurranse ===

Legg merke til at du ikke trenger å oppgi språkprefiks for mal-alias.
<blockquote>
<pre>
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}}.
</pre>
</blockquote>
gir
<blockquote style="border:1px solid #ccc; padding:10px;">
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}}.
</blockquote>

=== Konkurranse basert på Wikidata-spørring ===

Eksempel: for å lage en konkurranse om kvinnelige trompetister:

<blockquote>
<pre>
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 . }}
</pre>
</blockquote>
gir
<blockquote style="border:1px solid #ccc; padding:10px;">
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 . }}
</blockquote>

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 (<code>?item</code> i dette tilfellet) kommer først:

<blockquote>
<pre>
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]". }
}}
</pre>
</blockquote>

Alternativt kan man tilby en egen lenke til  [https://tools.wmflabs.org/hay/vizquery/#%0APREFIX%20wd%3A%20%3Chttp%3A%2F%2Fwww.wikidata.org%2Fentity%2F%3E%0APREFIX%20wdt%3A%20%3Chttp%3A%2F%2Fwww.wikidata.org%2Fprop%2Fdirect%2F%3E%0APREFIX%20wikibase%3A%20%3Chttp%3A%2F%2Fwikiba.se%2Fontology%23%3E%0APREFIX%20schema%3A%20%3Chttp%3A%2F%2Fschema.org%2F%3E%0APREFIX%20bd%3A%20%3Chttp%3A%2F%2Fwww.bigdata.com%2Frdf%23%3E%0ASELECT%20DISTINCT%20%3Fitem%20%3FitemLabel%20%3FitemDescription%20(SAMPLE(%3Fimage)%20AS%20%3Fimage)%20%3Fsitelink%20WHERE%20%7B%0A%20%20%3Fitem%20wdt%3AP31%20wd%3AQ5%20%3B%0A%20%20%20%20%20%20wdt%3AP1303%20wd%3AQ8338%20%3B%0A%20%20%20%20%20%20wdt%3AP21%20wd%3AQ6581072%20.%0A%0A%0A%20%20OPTIONAL%20%7B%20%3Fitem%20wdt%3AP18%20%3Fimage.%20%7D%0A%20%20OPTIONAL%20%7B%0A%20%20%20%20%3Fsitelink%20schema%3Aabout%20%3Fitem.%0A%20%20%20%20%3Fsitelink%20schema%3AisPartOf%20%3Chttps%3A%2F%2Fno.wikipedia.org%2F%3E.%0A%20%20%7D%0A%20%20SERVICE%20wikibase%3Alabel%20%7B%20bd%3AserviceParam%20wikibase%3Alanguage%20%22%5BAUTO_LANGUAGE%5D%2Cnb%2Cnn%2Cda%2Csv%2Cen%2Cde%22.%20%7D%0A%7D%0AGROUP%20BY%20%3Fitem%20%3FitemLabel%20%3FitemDescription%20%3Fsitelink%0ALIMIT%200%0A 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.
<blockquote>
<pre>
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 }}
</pre>
</blockquote>
gir
<blockquote style="border:1px solid #ccc; padding:10px;">
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 }}
</blockquote>

== Noter == 
{{Referanser|group=lower-alpha}}

== Se også ==
* [[Hjelp:Arrangere konkurranse]]
* {{ml|Ukens konkurranse poeng}}

<includeonly>
<!-- KATEGORIER OG INTERWIKIER UNDER DENNE LINJEN -->
[[Kategori:Maler for Ukens konkurranse|{{PAGENAME}}]]

</includeonly>