Modulu:Wikidata/dok

Modulu honek Wikidatatik datuak ateratzen ditu eta formatua ematen die.

Oinarrizko funtzioak

• claim: Adierazpen baten balioa (edo balioak) edo adierazpen baten kualifikadorea ematen du, aurrez esandako formatuan. Defektuz txertatuta dagoen artikuluaren itema bilatzen du (Qnnnn).

Beste funtzio batzuk:

• getParentValues: propietate baten emaitzak eta etiketak ematen ditu, gorantz, era errekurtsiboan.
• getTAValue: TA98 (Terminologia Anatomicaren lehen edizioa, 1998) emaitza ematen du P1323 propietatean. Ez ditu parametroak eskaintzen baina zerrenda bat ematen du kanpo-loturen formatu egokiarekin.
• ViewSomething: datu egituratuetako edozein gauza itzultzen du, etiketak, deskribapenak, erreferentziak edo interwiki loturak barne.
• years_old: pertsona baten adina itzultzen du: jaiotza data (p569) eta heriotza data (p570) arteko diferentzia eginez, edo ez badago P570 propietaterik, gaurko egunaren eta jaiotza data (p569) arteko aldea kalkulatzen du. Datuen prezisioaren arabera zifra bat edo bi ematen ditu. Bi datuetako bat mendeen arabera zehaztuta dagoenean ez du emaitzarik ematen.
  • Honako sintaxia erabiltzen du: {{#invoke:Wikidata |formatting=''tipus pattern'' |item= }}. item eta formatting hautazkoak dira. Formatu adibide bat izango litzateke ($1 urte)

Sintaxi osoa

{{#invoke:Wikidata|claim|property= |qualifier= |value= |list= |tablesort= |formatting= |separator= |conjunction= |item= |showerrors= |default= }}

Taula formatua emateko sintaxi osagarria

{{#invoke:Wikidata|claim|property= |qualifier= |qualifier2= |...|qualifier9= |tablesort= |rowformat= |rowsubformat1= |...|rowsubformat9= |formatting=table |separator= |conjunction= |item= |showerrors= |default= }}

Claim funtzioaren parametroak

• property= (beharrezkoa) Adierazpenaren propietatea, "P" eta zenbaki bat emanez. Wikidatako propietate guztien zerrenda ikusteko Propietateen zerrenda ikusi. Letra txikiz ere idatzi daiteke p, baina ez da gomendatzen. Propietatearen etiketa ere sar daiteke, adibidez property=herrialdea jartzen badugu property=P17 batean herrialdea (P17) jartzea bezalakoa da.
• qualifier= (aukeran) Kualifikatzailearen propietatea, "P" bat eta, jarraian, zenbaki bat. Wikidatako elementuan lotura agertzen da. p txikia ere sar daiteke, baina ez da formatu lehenetsia.
• value= (aukeran) Wikidatako balore preferentea. Izan daiteke txantiloian erabiltzen den parametro bat, {{{parametro|}}} formatoarekin. Horrela parametro horren balioa hartzen du eta, ez balego, Wikidatako balioa.
• list= (aukeran). Defektuz list=true hartzen du eta itemak dituen adierazpen eta kualifikatzaile guztiak ematen dizkigu (ikus separator eta conjuction).
  • list=false Balio bakarra ematen digu, mailarik altuena duena preferente/arrunta/obsolotoa mailaketaren arabera, edo mailarik altuena duenetik zaharrena.
  • list=firstrank Mailarik altuena duten baloreen zerrenda egiten du. list=true bezalakoa da adierazpen guztien maila berdina baldin bada.
  • tablesort=0 (aukeran) zerrendaren antolaketa gorantz egitea. Defektuz antolaketa mailaren arabera eta Wikidatako adierazpenaren antzinakotasunaren arabera ematen da.
• formatting= (aukeran) Nahi dugun formatua. Honako baloreak eman dakioke:
  • Elementuaren formatua (entity):
    • formatting=raw Elementuaren zenbakia emango digu.
    • formatting=label Elementuaren etiketa emango digu.
    • formatting=sitelink Elementuaren Wikipediako orrialdearen izenburua emango digu.
    • formatting=internallink Barne lotura posible baldin bda, izan Wikipediako loturarekin (sitelink) edo etiketarekin. Ez badago Wikipediako loturarik baina etiketaren bat baldin badago, defektuz Wikidatako lotura bat emango digu, gorriz. Etiketarik ez balego, ingelerazko etiketa hartzen du defektuz.
    • formatting=pattern Patroi baten araberako formatua, $1 erabiltzen aldatu behar den elementu gisa.

    Txantiloiak edo parser funtzioak sar daitezke honako formatua erabilita: {{((}}txantiloia{{!}}parametroa{{!}}izena{{=}}parametroa{{))}}

    Defektuz ematen den formatua lotura batena izango da.

  • Testu formatua (string):
    • formatting=weblink Kanpo lotura formatua [http://example.com example.com]
    • formatting=pattern $1 patroia erabiltzen du aldatu behar den parametro gisa. Adibidez: formatting=[http://whc.unesco.org/en/list/$1 $1]. Wikidatak lotura sortzen duen propietate motatan erabiltzen da, eta patro egokia propietatearen eztabaida orrialdean aurki daiteke.
  • Zenbaki formatua (quantity):
    • formatting=unit Zenbaki formatua, unitatea barne.
    • formatting=unitcode Zenbaki formatua, unitatearen laburdura jarriz, Modulu:Wikidata/Units moduluan zehazten duenaren arabra.
  • Formatu eleanitza (monolingualtext):
    • formatting=language Parametroaren balioa lortu nahi dugun hizkuntza kodea, monolingual text formatua duten parametroetarako, hala nola izen ofiziala (P1448).
    • formatting=text monolingual text formatua duten propietateetarako bertsio berezi bat da, bakar-bakarrik testua eskuratuz, formatting gabe eksatzen badugu hizkuntzaren kodea jasotzen baitu <span lang="en">United...</span>.
    • formatting=eu edo beste hizkuntza bateko balioa. Balio bakarra ematen du, kasu honetan monolingual text balio ezberdinen katalanezko bertsioa. Adibidez: etiketaren forma femeninoa (P2521).
  • Koordenatuen formatua (globecoordinate):
    • formatting=latitude Koordenatu adierazpen baten latitudea, formatu dezimalean
    • formatting=longitude Koordenatu adierazpen baten luzera, formatu dezimalean
    • formatting=dimension Koordenatu adierazpen baten dimentsioaren balioa, metrotan, koordenatuen mapentzako dim parametroa emateko.
    • formatting=globe (defektuz) {{koord}} txantiloiko globe parametroa ematen du, Lurretik kanpoko koordenaturen bat beharko balitz, erabiltzeko. Datuak [[Modulu:

Valor del paràmetre globe de la plantilla:coord, necessari per coordenades fora de la Terra. Les dades estan definides al Modulu:Gorputz zeleste/datuak moduluan zehaztu beharko lirateke (EGITEKE).

• • Daten formatua (time):
    • formatting= format #time [mw:Help:Extension:ParserFunctions/ca#.23time|#time analizadorarearen]] edozein formatu onartzen du. Adibidez formatting=d-m-Y (20-04-2024), formatting=[[j xg]] (20 Apiril), formatting=Y (2024). Defektuz "j F Y" (20 apirila 2024) erabiltzen du.
  • Propietate eta kualifikatzaileen taula formatua:
    • formatting=table Propietate zerrenda bat ematen du, taula formatuan, bere kualifikatzaileekin. 9 kualifikatzaile arte eman daitezke, eta formatuan bakoitza lerro batean sar dezake. Berez erabiltzen dituen bereizleak separator eta conjunction parametroetakoak dira. Formatu honek ematen dituen aukerak anitzak dira:
      • qualifier2 ... qualifier9= Lehen qualifier baino gehiago behar baditugu
      • rowformat= Propietate eta kualifikadoreen lerro bakoitzaren formatua. Propietatea $0 erabilita markatzen da, eta kualifikatzaileak $1etik $9ra. Defektuz rowformat=$0 ($1, ... $9) da formatua. Erabili daitezke zerrenda markak, * edo # baita txantiloiak ere {{((}}, {{!}} eta }} erabilita bereizketak egiteko.
      • rowsubformat1 ... rowsubformat9= $1-$9 arteko balioei emateko formatua definitzeko. Izan daiteke oso erabilgarria kualifikatzaile bat hutsik egonez gero. Adibidez, "rowformat=$0 $1" eta "rowsubformat1=zein $1" jarrita "$0 zein $1" jasoko dugu edo "$0" kualifikatzailerik ez balego.
      • colformat0 ... colformat9= Formatua ematen dio zutabe bakoitzari, 0 propietateari eta 1-9 artean kualifikadoreei. formatting balioak erabli daitezke zutabe bakoitzerako. Honela zutabe bati formatu zehatz bat eman ahal zaio.
      • tablesort= 0 eta 9 arteko balioekin, propietate eta kualifikatzaileen arabera antolatzen du taula. Defektuz propietatearen mailaren arabera antolatuko du, edo Wikidatako definizioaren antzinakotasunaren arabera.
      • sorting=-1 ordena aldatzen du, atzekoz aurrera egiten. Defektuz goranzkoa da.
• separator= (aukeran) zerrendan edo taulan erabiltzeko bereizlea. Defektuz komaz bereizten da, euskaraz , erabilita. Tauletan defektuz lerro haustura bat egiten du: <br />.
• conjunction= (aukeran) Zerrenda bateko azken bi elementuen artean erabiltzeko konjuntzioa. Defektuz eta erabiltzen du. Tauletan <br /> erabiltzen du.
• case= (aukeran) Sortu behar den kasu gramatikala. Definitutako kasuak:
  • case=singularra, hitz baten forma singularra ekartzen du, adibidez irakasle -> irakaslea
  • case=ergatiboa, hitz baten edo zerrenda baten forma ergatiboa ekartzen du, adibidez Stanley Kubrick -> Stanley Kubrickek
  • case=genitiboa, hitz baten edo zerrenda baten forma genitiboa ekartzen du, adibidez Mikel Laboa -> Mikel Laboaren

• item= (aukerakoa) Erabiltzen ari garen artikulua ez den beste item bat zehazteko balio du, eta (Qnnnn) formatuan eman behar da. Moderazioz erabili, arren, errekurtso ugari erabiltzen baititu.
• itemgender= (aukerakoa) Elementuaren forma femenikoa aurkitzen da, sexua edo generoa (P21) erabilita, defektuz item erabilita. case=gender eta case=infoboxlabel batera erabiltzen da.
• showerrors= (aukeran) Errore mezuak ematen ditu.
• default= (aukeran) Akatsik balego eman beharreko mezua. Ez du efekturik showerrors jartzen badugu.

getParentValues funtzioaren parametroak

• item= (aukeran) Item bat (Qnnnnn) zehaztea baimentzen du. Wikidatarako sarbide arbitrario hau ez da gomendagarria, baliabide asko behar baititu.
• property= (aukeran) Adierazpenaren propietatea, "P" eta zenbaki baten formatuan. Defektuz honako erakunde administratiboan dago (P131) izango da.
• label= (aukeran) Etiketaren propietatea. Defektuz honako hau da (P31) izango da.
• valuetext= (aukeran) Balioaren loturaren testuaren propietatea. Defektuz formatting=internallink emango du.
• upto= (aukerak) Noraino iritsi nahi dugun kontsultzen zuhaitzan, propietaterik aurkitzen duen bitartean. Balio motak
  • upto=etiketa: gelditu behar den etiketa, adibidez "upto=herrialdea".
  • upto=zenbakia: lortu nahi diren balio kopurua. Defektuz 10 datoz, babes gisa, baina normalki ez dira hainbeste behar izango.
• labelshow= (aukeran) Erakutsi nahi diren etiketen iragazkia, barar batekin bereiztua bat baino gehiago baidra. Adibidez "labelshow=udalerria/eskualdea"
• sorting= (aukeran) Zerrendan ordena. Balio posible bakarra du, "sorting=-1", berezkoaren alderantziko ordena erakusteko.
• rowformat= (aukeran) balio bikote bakoitza antolatzeko modua, $0 etiketarako eta $1 baliorako. Defektuz "rowformat=$0 = $1" erabili da, adibidez "eskualdea = [[Iruñerria]]" erakutsiz.
• separator= (aukeran) Balio bikote bakoitzarentzat nahi dugun bereizlea. Defektuz <br /> da. Ez da konjuntziorik behar bereizleentzat, kasu honetan.

Oharra: Etiketak aldatu daitezke formatu hobe batekin infotaulatan erabiltzeko. Adibidez, "Brasilgo udalerria"ren ordez "Udalerria" ikusiko dugu. Hau guztia Modulu:Wikidata/labels moduluan zehazten da, bertan jarriz behar ditugun aldaketak.

Adibideak

• Erabiler sinplea:

{{#invoke:Wikidata | claim |property=P20}} Jean-François Champollion artikuluan honako emaitza emango du: Paris

heriotza lekua (P20) propietatea da, elementua erakutsiz.

• Loturarik gabe:

{{#invoke:Wikidata | claim | property=P20 | formatting=label}}: Paris

• Balio lehenetsia

{{#invoke:Wikidata | claim | property=P20 | value={{{heriotza lekua|}}} }} infotaulan {{{heriotza lekua|}}} definitu badugu agertuko da, bestela Paris jarriko du.

• Data modukoa:

{{#invoke:Wikidata | claim | property=P569}} jaitza data ematen du berezko formatuan:

1790eko abenduaren 23a eta 1790eko abenduaren 22a

• Patroi batekin emandako datuak:

{{#invoke:Wikidata | claim | property=P214 | formatting=[http://viaf.org/viaf/$1 $1]}}:

34454460

• Balio bakarra:

Adibide irudia

{{#invoke:Wikidata | claim | property=P18 | list=false | formatting=[[File:$1|thumb|upright=.5|Adibide irudia]]}}

Definitu den lehen irudia baino ez du emango.

• Kanpo loturaren formatua:

{{#invoke:Wikidata | claim | property=P856 | formatting=weblink}} Berlin artikuluan:

berlin.de…

• Balio zerrenda:

mugakidea(k) (P47) {{#invoke:Wikidata | claim | property=P47}} Bilbo artikuluan

Alonsotegi, Arrigorriaga, Barakaldo, Basauri, Erandio, Galdakao, Sondika, Zamudio, Derio eta Etxebarri

• Formatudun zerrenda

osatuta (P527) {{#invoke:Wikidata | claim | property=P527 | separator=<br /> | conjunction=<br />}} Euskal Herrian:

Araba
Bizkaia
Gipuzkoa
Nafarroa Garaia
Lapurdi
Nafarroa Beherea
Zuberoa
Trebiñu
Argantzon
Eskiula

• Koordenatuak:

{{#invoke:Wikidata | claim | property=P625 | formatting=latitude}}: 43.2622

{{#invoke:Wikidata | claim | property=P625 | formatting=longitude}}: -2.9533

Ikus, gainera

• mw.wikibase liburutegia