Modul:External links/conf/Offisielle lenker/dok

Modulen "External links/conf/Offisielle lenker/dok" inneholder konfigurasjon som brukes av Modul:External links

Det er i variabelen configured_claims en rekke rader som beskriver hvilke wikidata-egenskaper som skal benyttes for å lage eksterne lenker i artikler. Disse radene er bygd opp på følgende måte:

{ prop='Pnnnn', message ="$3 [$2 ''$1''] <beskrivelse>", short="[$2 <tekst>]", langcode ='aa', url="...", url_f=<function>, regex="...", genitiv=<boolean>, track=<boolean> },

Hvor følgende er tilfelle:

• prop - er property-navnet som skal behandles.
  • Pnnnn - Dersom denne er en "P" etterfulgt av et nummer (Pnnnn), antas det at dette er et Property-nummer på Wikidata som skal sjekkes. F.eks. P345 som da er nummeret for IMDB sine lenker. Hvis dette finnes for artikkelen, vil en ekstern lenke for denne egenskapen potensielt vises frem.
  • SLaaaa - Dersom denne består av "SL" etterfulgt av et interwikinavn, f.eks. SLspecieswiki, vil det forsøkes å hente navnet på tilsvarende artikkel på den andre wikien, med understreker for mellomrom.
  • Dersom det er et annet property-navn, behandles dette som en ren lokal definisjon og trenger å få verdien/identifikatoren fra oppkallet av modulen. Se eksempel nedenfor.
• message - er teksten som skal vises frem i artikkelen. Denne har to spesial-verdier: $1 og $2. Disse to vil erstattes med følgende:
  • $1 - Erstattes med artikkel-navnet. Se også genitiv under.
  • $2 - Erstattes med den rå-URL'en til den eksterne lenken. F.eks. http://www.imdb.com/title/tt0085255/
  • $3 - Erstattes med en språkkode. F.eks. (en) for engelsk språk. Se langcode.
  • $4 - Erstattes av selve verdien.
  • $5 - Erstattes av en URI-formatert versjon av selve verdien.
• short - er en kort-versjon av teksten om skal vises frem. Denne har to spesial-verdier: $1 og $2. Disse to vil erstattes tilsvarende som for message ovenfor.
• langcode - Her legges inn språkkoden for nettstedet. Denne brukes for å lage en indikasjon på hvilket språk nettstedet er skrevet. Dersom en P-verdi legges inn her, vil modulen lete etter denne P-verdien som en qualifier under P305 (verkets språk). Det er pr. i dag kun støttet P407 her.
• url_f - Her kan det legges inn en formaterings-funksjon for URL'ene som skal kalles opp. Dette er kun navnet på funksjonen (som må være definert lokalt ovenfor configured_claims i denne modulen. Funksjonen vil kalles opp med én variabel som er identifikatoren som kommer fra wikidata eller lokalt og det forventes en ferdig rå-URL tilbake. Eksempel: url_f=imdb_formatter. Denne funksjonen er første prioritet ved valg mellom flere muligheter.
• url - Her kan det legges inn URL'en som skal kalles opp. Eksempel: url="http://www.imdb.com/tt/$1". Denne strengen er andre prioritet ved valg mellom flere muligheter. Denne har en spesial-verdi: $1 som vil erstattes med følgende:
  • $1 - Erstattes med identifikatoren som kommer fra wikidata eller lokalt.
• regex - Her kan det legges inn en regexp-streng som vil brukes for å verifisere at identifikatoren som kommer fra wikidata eller lokalt har korrekt format. Eksempel: regex="tt\\d+". Dersom denne er definert, må identifikatoren passere denne testen først. Hvis det finnes relevante regexp-strenger på wikidata, vil disse sjekkes også, men etter denne.
• genitiv - Dette er en variabel som bestemmer om det skal brukes genitiv på artikkelnavnet som erstatter $1 (se over). Denne kan enten være true (sann) eller false (usann).
• track - Dette er en variabel som bestemmer om bruken av denne egenskapen skal melde inn artikkelen i en kategori. Kategorien styres av definisjonen lenger ned (['tracking-cat-found-data'] eller ['tracking-cat-found-local']). Denne kan enten være true (sann) eller false (usann).

Se også definisjonen av maksimum antall lenker som vil vises frem i artiklene i variabelen limits som ['links-shown'] = 10