Por eviti la riskon deredaktokonflikto, ne redaktu la artikolon. Kontrolu lakronologion kaj forigu la ŝablonon, se necese.
Ĉi tiu modulo ekzistas en multaj projektoj, sed kun multaj malsamaj funkcioj kaj funkcionomoj. Ili ne estas kongruaj unu kun aliaj.
Atentigo: Por testi la datuman ekstraktadon per ĉi tiu modulo, povas esti uzataWikipedia:Wikidata/Wikidata provejo kaj la rilata datuma objektoQ4115189, kiu ebligas ankaŭ liberan prilaboradon de ties proprietoj.
Funkcioj por ŝablonoj
La sekve donotaj ekzemploj rilatas al tio, ke la modulo estas uzata sur la paĝode:Berlin resp. ties ligita Vikidatuma objektoQ64. La ĉi tie listigitaj rezultoj de ekzemploj estas ev. ne aktualaj.
claim
Redonas deklaron de Vikidatuma objekto ligita kun la aktuala paĝo. Deklaroj estas ĉe tio proprietoj de Vikidatuma objekto. Ĉi tiu funkcio ofertas disvastigitan funkciecon kompare al la vikie enplektita{{#property:}}.
Parametroj:
1 – la Id de la proprieto (P…) aŭ la proprietonomo, kies deklaro estu redonata. Pro performancaj (rapidecaj) kaj persistaj kialoj (la nomo de proprieto povas ŝanĝiĝi) la aldono de Id estu preferata.
id – Id (Q…) de Vikidatuma objekto, al kiu estu akcesata. Se ĝi ne estas donita, tiam estas uzata tiu ligita kun la aktuala paĝo.
qualifier – Deklaroj povas enhavi kvalifikatoron, ekz. por kiudato(P585) deklaro validas aŭ kiudetermina metodo(P459) estis uzata
parameter – Deklaroj konsistas el kompleksaj datumtipoj, el kiuj normale nur la plej gravaj elementoj estas redonataj. Perparameter ĉi tiu "konduto" povas esti ŝanĝata. La unuopaj datumtipoj kaj ties eblaj parametroj estas (separameter ne estas donata, la grase skribita elemento estas redonata):
Dato/tempo:time [ISO 8601],time:format(alĝustigita formatigo laŭde:Hilfe:Vorlagenprogrammierung#Funktion time),timezone [Minutoj],before, after, precision(0 - Mrd. jaroj, 1 - 100 Mio. jaroj, ..., 6 - jarmilo, 7 - jarcento, 8 - jardeko, 9 - jaro, 10 - monato, 11 - tago, 12 - horo, 13 - minuto, 14 - sekundo),calendarmodel[Wikidata-URI, ekz. http://www.wikidata.org/entity/Q1985727 por la prolepta gregoria kalendaro aŭ http://www.wikidata.org/wiki/Q11184 por la julia kalendaro]
Wikidata-IDs:entity-type, numeric-id (Norme la titolo de la Vikidatuma objekto nomata per numeric-id estas redonata),link por Vikia ligilo
Teksto kun lingva markigo:language,text (Norme<span lang="[language]">[teksto]</span> estas redonata)
language – kondiĉe ke proprieto posedas plurajn deklarojn kun lingvaj markigoj, estas redonata tiu deklaro, kiu estas en la lingvo de la donita lingva mallongigo (ekz.language=de por la germana,language=en por la angla aŭlanguage=eo por esperanto)
list – se proprieto posedas plurajn deklarojn, eldonu ĉiujn kun la donita lista apartigilo (uzi\n resp.<br /> por linisalto)
includeempty – Lista apartigilo ankaŭ estas eldonata kaze de malplenaj valoroj
references – eldoni la donitajn fontojn (Atentigo: La eldono nuntempe ne sekvas la skemon por fontindikoj)
sort – Ordigo laŭ kvalifikatoroj
sortInItem – se la deklaroj de proprieto reprezentas Vikidatumajn erojn (angleWikidata-Items), do estas serĉata en ĉi tiu ero laŭ la ensortInItem donita proprieto kaj la valoro estas uzata kiel ordiga ŝlosilo. Atentu: bezonas sufiĉe da kalkulaj risurcoj!
inverse – eldonas la ordigitajn valorojn en inversaj sinsekvo
hasqualifier – eldonas nur deklarojn kun kvalifikatoroj. Povas esti limigata per proprieta Id (P…) al certa kvalifikatoro.
hassource – eldonas nur deklarojn kun referencoj. Povas esti limigata per proprieta Id (P…) al certa referenco. !P… ignoras referencon.
atdate – eldonas nur deklarojn, kiuj validas laŭ la donita en kvalifikatoroekde(P580) kajĝis(P582) je la donita dato. Ĉe forestanta dato, estas uzata la hodiaŭa dato.
showerrors – se neniu deklaro povas esti trovata, difinas la kialon
Ekzemploj:
{{#invoke:Wikidata|claim|P1082|id=Q64}} →3401147 por la proprietoloĝantaro(P1082). Numeroj estas redonataj kontraŭe al{{#property:}} sen decimalaj punktoj.
{{#invoke:Wikidata|claim|P1082|id=Q64|qualifier=P585}} →31. August 2013 por la kvalifikatorodato(P585) de la proprietoloĝantaro(P1082)
{{#invoke:Wikidata|claim|P1082|id=Q64|qualifier=P585|parameter=time}} →2013-08-31T00:00:00Z. Elvoko de la (normaligita) neprilaborita dato.
{{#invoke:Wikidata|claim|P6|list=, }} →Klaus Wowereit, Eberhard Diepgen, Walter Momper, Eberhard Diepgen, Richard von Weizsäcker, Hans-Jochen Vogel, Dietrich Stobbe, Klaus Schütz, Heinrich Albertz, Willy Brandt, Franz Amrehn, Otto Suhr, Walther Schreiber, Ernst Reuter por la proprietoestro(P6)
Pluraj deklaroj povas esti redonataj disigitaj per apartigilo, en multaj kazoj tamen estu preferata pli bone formatigita varianto. Tial estos supozeble implementata perŝablona redono.
Tio ebligas uzon de pli ol unu referenco en la sama Vikidatuma ero. Ĉe tior enhavas la transprenitan informon el Vikidatuma ero kajref la referencon.
getValue
Kombinas la funkciecon declaim kun la funkciogetValue de la anglaModule:Wikidata, t.e. nur Vikidatumo estas pridemandata, se tio estas aldonata eksplicite (normale dum la plenigo deŝablono). Ĉe uzado en ŝablono tio transdonas la kontrolon, ĉu Vikidatumoj estu uzataj, al la pleniganto de ŝablono. Tio povas esti helpa ĉe tio, teni laVikikodon de ŝablono komprenebla.
Atentigo: La angla Vikidatuma modulo ĉegetValue ĉiam eliras de tio, ke la pridemandata proprieto estas ligilo al Vikipedia artikolo kaj ligas al ĝi. Ĉi tiu aŭtomata ligado ĉi tiene okazas, sed devas esti difinata kiel en la malsupre donita ekzemplo eksplicite.
2 – Ĉiam redonas ĉi tiun donitan valoron, krom ke ĉi tie estasPETI_VIKIDATUMOJN, ĉe kio tiam la functioclaim estas elvokata. (La anglaFETCH_WIKIDATA ankaŭ funkcias, sed estu evitata favore al la esperanta versio.) Per antaŭdifinitaPETI_VIKIDATUMOJN en la ŝablono la pridemando ankaŭ povas okazi, se parametro ne estis difinita.
Ekzemplo:Supozite ke la ŝablonoInfobox Staat (ĉe ni {{Informkesto lando}}) uzas pro la eldono de la proprieto ĉefurbo la ŝablonan kodon{{#invoke:Wikidata|getValue|P36|{{{ĉefurbo|}}}|parameter=link}} kaj en la artikolo Germanio tio estu plenigita jene:
Redonas la Id de Vikidatuma objekto, por ekzemple kontroli, ĉu la aktuala paĝo estas ligata kun Vikidatuma objekto aŭ ĉu la Vikidatuma objekto estas alidirektilo al alia Vikidatuma objekto.
Parametro:
1 – Id (Q…) de la Vikidatuma objekto al kiu estu akcesata. Se ĝi ne estas donata, la ligita kun la aktuala paĝo estas uzata.
Ekzemplo:
{{#invoke:Wikidata|pageId}} →Q64, se vokata sur la paĝo Berlino
{{#invoke:Wikidata|pageId|Q18511155}} →Q9404406, ĉar alidirektilo
sitelinkOf
Redonas la titolon de la paĝo en la esperanta Vikipedio ligita kun la Vikidatuma elemento.
Parametro:
1 – Id (Q…) de la Vikidatuma objekto al kiu estu akcesata. Se ĝi ne estas donata, tiam tiu ligita kun la aktuala paĝo estas uzata.
Nombras la paĝojn ligitajn kun la Vikidatuma objekto.
Parametroj:
1 – Projekta filtrilo. Normale ĉiuj Vikiaj projektoj estas konsiderataj, ĉewiki nur la Vikipediaj lingvaj versioj kaj Komunejo, ĉewikibooks,wikinews,wikiquote,wikisource kajwikivoyage ĉiam nur la lingvaj versioj de ĉi tiuj projektoj. Krome ankaŭ konkrete povas esti aldonata lingva versio kielenwiki, kiu siavice redonas 0 aŭ 1, depende de tio ĉu ekzistas artikolo en la lingva versio.
2 – Id (Q…) de la Vikidatuma objekto al kiu estu akcesata. Se ĝi ne estas donata, tiam tiu ligata kun la aktuala paĝo estas uzata.
Ekzemploj:
{{#invoke:Wikidata|sitelinkCount}} →327, se vokata sur la paĝo Berlino
{{#invoke:Wikidata|sitelinkCount|wiki}} →267, se vokata sur la paĝo Berlino
{{#invoke:Wikidata|sitelinkCount|wikinews}} →16, se vokata sur la paĝo Berlino
badges
Redonas la distingojn de la paĝo ligita kun la Vikidatuma objekto en la donita Vikimedia projekto. La distingoj kutime estasleginda artikolo(Q17437798) aŭelstara artikolo(Q17437796). Pluraj distingoj ne estu, sed estus eldonataj apartigitaj per oblikvaj strekoj.
Parametroj:
1 – Id de la Vikimediaj projektoj, ekz.enwiki por la angla Vikipedio.
2 – Id (Q…) de la Vikidatuma objekto al kiu estu akcesata. Se ĝi ne estas donata, tiam tiu ligita kun la aktuala paĝo estas uzata.
Ekzemplo:
{{#invoke:Wikidata|badges|dawiki}} → ' (leginda artikolo de la dana Vikipedio), se vokata sur la paĝo Berlino
Debug-funkcioj
La sekvaj funkcioj povas esti elvokataj sur Vikipediaj paĝoj (precipeSpecialaĵo:Malfaldi ŝablonon) por debuggaj aŭ evoluaj celoj, por ricevi pli detalajn informojn pri programeraroj kaj Vikidatumaj datumaj strukturoj.
printEntity
Redonas ĉiujn Vikidatumajn datumojn ligitajn kun la aktuala paĝo.
Parametro:
1 – Id (Q…) de la Vikidatuma objekto al kiu estu akcesata. Se ĝi ne estas donita, tiam estas uzata tiu ligita kun la aktuala paĝo.
debug
Se modula alvoko redonas skripteraron, per tio povas esti elvokataj la faktaj erarinformoj (erarpriskriboj kaj evtl. loko).
Parametro:
1 – Nomo de la funkcio
pliaj parametroj – Parametroj de ĉi tiu funkcio
Ekzemplo:
{{#invoke:Wikidata|debug|claim|P1082|qualifier=P585}} anstataŭ{{#invoke:Wikidata|claim|P1082|qualifier=P585}} por ricevi konkretan erarinformon pri la lasta, se tie aperas skripteraro.
Submodulaj funkcioj
Ekzistas kelkaj submoduloj, kies funkcioj parte jam estas uzeblaj:
Se priskribo jam ekzistas en la nomita Vikidatuma ero, sufiĉas la jenas kodo:
{{#invoke:Wikidata/bildoj|bildoj}}
Se la priskribo forestas, ĝi povas esti transdonata aparte, jene:
Ĉe unusola bildo:
{{#invoke:Wikidata/bildoj|bildoj|priskribo de bildo=}}
Ĉe pli ol unu bildo estas du variantoj:
{{#invoke:Wikidata/bildoj|bildoj|priskribo de bildoj=priskribo1 ;;; priskribo2}}{{#invoke:Wikidata/bildoj|bildoj|priskribo de bildo1=priskribo1|priskribo de bildo2=priskribo2}}
