Vikipedio:Lua/Moduloj/Wikidata/eo
Ŝablona programado | Diskutoj | Lua | Testoj | Subpaĝoj | |||
---|---|---|---|---|---|---|---|
Modulo | Esperanto
|
Deutsch
|
Modulo: | Dokumentado |
Wikidata
– Modulo por elvoko de informoj el Wikidata baziĝantaj sur la Wikibase Client Lua-API.
Ĉ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 uzata Wikipedia:Wikidata/Wikidata provejo kaj la rilata datuma objekto Q4115189, kiu ebligas ankaŭ liberan prilaboradon de ties proprietoj.
Funkcioj por ŝablonoj[redakti fonton]
La sekve donotaj ekzemploj rilatas al tio, ke la modulo estas uzata sur la paĝo de:Berlin resp. ties ligita Vikidatuma objekto Q64. La ĉi tie listigitaj rezultoj de ekzemploj estas ev. ne aktualaj.
claim
[redakti fonton]
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:
|
Ekzemploj:
|
Ankoraŭ mankas:
- 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.
references
kontraŭ la rekomendoj de d:Wikidata:Requests for comment/References and sources testi kaj kontroli ĉu la<ref>
povas esti kreata aŭtomate per la ŝablonoj {{Citaĵo el la reto}} kaj/aŭ {{Citlibro}}.
Aldono[redakti fonton]
Kompare al la germana praulo nia modulo havas aldonon, tiel ke ĉe la enplektado en aliaj moduloj eblas la jeno:
wikidata.claim({args={pk,references="raw"} })
Ekzemplo por tio troveblas en la modulo {{geografiaĵoj}} jene:
r, ref = wikidata.claim({args={pk,references="raw"} })
Tio ebligas uzon de pli ol unu referenco en la sama Vikidatuma ero. Ĉe tio r
enhavas la transprenitan informon el Vikidatuma ero kaj ref
la referencon.
getValue
[redakti fonton]
Kombinas la funkciecon de claim
kun la funkcio getValue
de la angla Module: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 la Vikikodon de ŝablono komprenebla.
Atentigo: La angla Vikidatuma modulo ĉe getValue
ĉiam eliras de tio, ke la pridemandata proprieto estas ligilo al Vikipedia artikolo kaj ligas al ĝi. Ĉi tiu aŭtomata ligado ĉi tie ne okazas, sed devas esti difinata kiel en la malsupre donita ekzemplo eksplicite.
Parametroj:
|
Ekzemplo:
Supozite ke la ŝablono Infobox Staat (ĉe ni {{Informkesto lando}}) uzas pro la eldono de la proprieto ĉefurbo la ŝablonan kodon
Se valoro estis antaŭdifinita per
|
descriptionIn
[redakti fonton]
Redonas la Vikidatuman priskribon de la Vikidatuma objekto en la donita lingvo (Vikia lingvokodo).
Parametroj:
|
Ekzemplo:
|
labelIn
[redakti fonton]
Redonas la Vikidatuman titolon de la Vikidatuma objekto en la donita lingvo (Vikia lingvokodo).
Parametroj:
|
Ekzemplo:
|
labelOf
[redakti fonton]
Redonas la esperantlingvan titolon de la donita Vikidatuma objekto aŭ proprieto.
Parametro:
|
Ekzemplo: |
pageId
[redakti fonton]
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:
|
Ekzemplo:
|
sitelinkOf
[redakti fonton]
Redonas la titolon de la paĝo en la esperanta Vikipedio ligita kun la Vikidatuma elemento.
Parametro:
|
Ekzemplo:
|
sitelinkCount
[redakti fonton]
Nombras la paĝojn ligitajn kun la Vikidatuma objekto.
Parametroj:
|
Ekzemploj:
|
badges
[redakti fonton]
Redonas la distingojn de la paĝo ligita kun la Vikidatuma objekto en la donita Vikimedia projekto. La distingoj kutime estas leginda artikolo (Q17437798) aŭ elstara artikolo (Q17437796). Pluraj distingoj ne estu, sed estus eldonataj apartigitaj per oblikvaj strekoj.
Parametroj:
|
Ekzemplo:
|
Debug-funkcioj[redakti fonton]
La sekvaj funkcioj povas esti elvokataj sur Vikipediaj paĝoj (precipe Specialaĵo:Malfaldi ŝablonon) por debuggaj aŭ evoluaj celoj, por ricevi pli detalajn informojn pri programeraroj kaj Vikidatumaj datumaj strukturoj.
printEntity
[redakti fonton]
Redonas ĉiujn Vikidatumajn datumojn ligitajn kun la aktuala paĝo.
Parametro:
|
debug
[redakti fonton]
Se modula alvoko redonas skripteraron, per tio povas esti elvokataj la faktaj erarinformoj (erarpriskriboj kaj evtl. loko).
Parametro:
|
Ekzemplo:
|
Submodulaj funkcioj[redakti fonton]
Ekzistas kelkaj submoduloj, kies funkcioj parte jam estas uzeblaj:
- {{Wikidata/bildoj}}
- {{Wikidata/geografio}}
bildoj
[redakti fonton]
Ĝi redonas bildon aŭ eble eĉ bildojn el la Vikidatuma ero bildo (P18). La rilataj priskriboj troveblas en priskribo de plurmediaĵo (P2096).
Parametroj:
|
En la Vikidatuma ero de la artikolo Vajmaro {{#invoke:Wikidata/bildoj|bildoj}} redonas |
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}}
Kodopeco el {{Informkesto urbo}}
{{#invoke:Wikidata/bildoj|bildoj|priskribo de bildoj={{{priskribo de bildoj|}}}|priskribo de bildo={{{priskribo de bildoj|{{{bildo-priskribo|}}}}}}}}
geografio
[redakti fonton]
Ĝi redonas geografiajn informojn, kiel ekz. pri alteco
(supermara alteco (P2044)), areo
(areo (P2046), Subdividoj
(subdividoj (P150), administraUnuo
(troviĝas en administra unuo (P131) kaj transkalkulas areon al km² (funkio areoKM2
) resp. ha (funkcio areoHA
).
Funkcioj por moduloj[redakti fonton]
_pageId(id)
povas esti jam uzata en aliaj moduloj. Ekzemplo troviĝas en la funkcioinformkesto
en la modulo {{Biografio}}, nome jene:
local wikidata = require ("Modulo:Wikidata")
local wdl = wikidata._pageId()
Ankaŭ la aliaj funkcioj estas uzeblaj, sed iomete alie, nome laŭ la jena skemo:
local bildaro = wikidata.claim({args = { "P18", list=";;;", id = id} })
Uzado[redakti fonton]
Ĝenerala biblioteko.
Dependeco[redakti fonton]
- Ĉe {{Wikidata}} - neniu
- Ĉe {{Wikidata/bildoj}} - la sekvaj moduloj:
- {{Wikidata}} - nur por la erarmesaĝoj
- {{InfoboxImage}} - por montri bildojn
- {{Listutil}} - por nombri la bildojn
Deveno[redakti fonton]
- de:Modul:Wikidata el la germana vikipedio, en la versio de la 17-a de oktobro 2015, sed jam kun alĝustigoj kaj aldonoj de Tlustulimu (diskuto • kontribuoj • alŝutitaj dosieroj • globala kontribuado • protokolo pri forbaroj • protokolo • SUL )