Mòdul:Wikidata/ús: diferència entre les revisions

Contingut suprimit Contingut afegit
actualització de ca.wiki
actualitzo
Línia 1:
Aquest mòdul extrau dades formatades de Wikidata. Funciona en la llengua local del wiki, o en una llengua específica per a proves, i té opcions de configuració.
 
== Funcions ==
Funció bàsica:
* <code>[[#Funció claim|claim]]</code>: Retorna amb un format determinat el valor (o els valors) d'una declaració o deld'un qualificador d'unaformatat declaració.amb Perparàmetres defecteo estàamb referitun aformat l'itemper (Qnnnn)defecte desegons l'articleel tipus de actiudada.
Altres funcions:
* <code>[[#Funció getLabel|getLabel]]</code>: retorna una etiqueta en la llengua especificada, o la llengua per defecte.
* <code>[[#Funció getParentValues|getParentValues]]</code>: retorna etiquetes i valors superiors d'una propietat de forma recursiva.
* <code>[[#Funció linkWithParentLabel|linkWithParentLabel]]</code>: crea un enllaç amb l'etiqueta d'una propietat superior. Per exemple per enllaçar {{P|P405}} amb l'etiqueta {{P|P835}} definida en el corresponent ítem superior.
* <code>[[#Funció yearsOld|yearsOld]]</code>: retorna l'edat d'una persona: diferència entre {{p|P569}} i {{p|P570}}, quan estan les dues propietats; o diferència entre {{p|P569}} i la data d'avui, si no hi ha P570. Retorna una (nn) o dues xifres (nn/mm) segons la precisió de les dates. No retorna res quan alguna de les dues està expressada en segles.
* <code>getTAValue</code>: retorna els valors de TA98 (''Terminologia Anatomica'' primera edició 1998) de la propietat P1323. No pren paràmetres i retorna una llista amb cada valor enllaçat a la font externa.
Altres [[#Utilitats|utilitats]]: getSiteLink, lang, numStatements.
* <code>yearsOld</code>: retorna l'edat d'una persona: diferència entre {{p|p569}} i {{p|p570}}, quan estan les dues propietats; o diferència entre {{p|p569}} i la data d'avui, si no hi ha P570. Retorna una (nn) o dues xifres (nn/mm) segons la precisió de les dates. No retorna res quan alguna de les dues està expressada en segles.
 
== Funció claim ==
Retorna el valor (o els valors) d'una declaració o d'un qualificador formatat amb paràmetres o amb un format per defecte segons el tipus de dada. Per defecte està referit a l'ítem de Wikidata (Qid) associat a la pàgina actual.
 
Sintaxi completa:
:<code><nowiki>{{#invoke:Wikidata</nowiki>{{ROOTPAGENAME}}<nowiki>|claim|item= |lang= |property= |qualifier= |value= |list= |tablesort= |formatting= |separator= |conjunction= |item= |lang= |editicon= |showerrors= |default= }}</nowiki></code>
 
Sintaxi addicional pel format de taula:
:<code><nowiki>{{#invoke:Wikidata</nowiki>{{ROOTPAGENAME}}<nowiki>|claim|item= |lang= |property= |qualifier= |qualifier2= |...|qualifier</nowiki>''x''<nowiki>= |formatting=table |tablesort= |sorting= |rowformat= |rowsubformat1= |...|rowsubformat</nowiki>''x''<nowiki>= |colformat0= |...|colformat</nowiki>''x''<nowiki>= |case0= |...|case</nowiki>''x''<nowiki>= |separator= |conjunction= |item= |lang= |editicon= |showerrors= |default= |references= }}</nowiki></code>
 
=== Paràmetres: generals ===
*<code>item=</code> (opcional) Permet indicar un ítem (Qid) diferent a l'ítem associat a la pàgina actual. Cal fer-lo servir <u>amb moderació</u> pel seu <u>alt consum</u> de recursos. Es pot usar també com a paràmetre de l'entorn superior de la plantilla. Té com a àlies <code>from</code>.
*<code>property=</code> (obligatori) Propietat de la declaració, amb format "P" seguit d'un número. Es pot veure enllaçat en l'element de Wikidata i una llista completa a [[d:Special:MyLanguage/Wikidata:List of properties|Llista de propietats]]. Accepta també una p minúscula, però no és recomanat. Igualment accepta l'etiqueta de la propietat, per exemple property=estat equival a property=P17 per la propietat {{P|P17}}.
 
*<code>lang=</code> (opcional) Permet indicar el codi d'una llengua determinada. Es pot usar també com a paràmetre de l'entorn superior de la plantilla. Per defecte usa la llengua local del wiki per a l'espai principal d'articles o la llengua d'usuari definida en les preferències per a altres espais de noms. Si no troba el valor en aquesta llengua ho intenta en les llengües alternatives definides en el MediaWiki. Per exemple per català les llengües alternatives són occità i anglès. En cas que el valor no s'hagi trobat en la llengua demanada, hi afegeix el codi de llengua i una icona d'etiqueta per a traduir-ho a Wikidata. Aquesta icona es pot eliminar amb el paràmetre editicon.
*<code>qualifier=</code> (opcional) Propietat del qualificador, amb format "P" seguit d'un número. Es pot veure enllaçat en l'element de Wikidata. Accepta també una p minúscula, però no és recomanat.
 
*<code>property=</code> (obligatori) Identificador de la propietat de la declaració (Pid). Es poden definir diferents propietats alternatives amb qualsevol separador, per exemple "P17 o P131", i obtindrà la primera que trobi. Accepta també una p minúscula, però no és recomanat. Igualment accepta l'etiqueta de la propietat, per exemple property=estat equival a property=P17 per la propietat {{P|P17}}.
*<code>value=</code> (opcional) Valor preferent al de Wikidata. Pot ser un paràmetre opcional en una plantilla amb el format <nowiki>{{{paràmetre|}}}</nowiki>, així si existeix pren el valor del paràmetre i sinó el valor de Wikidata.
 
*<code>qualifier=</code> (opcional) Qualificador (Pid) del valor de la propietat.
*<code>list=</code> (opcional). Per defecte assumeix list=true traient una llista dels valors de totes les declaracions o els qualificadors (vegeu ''separator'' i ''conjuction'').
** <code>list=false</code> o <code>list=no</code> Treu només un valor, el de rang més alt segons l'ordre preferent/normal/obsolet, o el més antic dels que tenen el rang més alt.
** <code>list=firstrank</code> Treu la llista dels valors amb el primer rang més alt. És equivalent a list=true si tots tenen el mateix rang.
** <code>tablesort=0</code> (opcional) ordenació ascendent de la llista. Per defecte l'ordenació és pel rang (preferent, normal, obsolet) i per l'antiguitat de definició a Wikidata.
** <code>list=lang</code> En cas de valors multilingües només treu els corresponents a la llengua del paràmetre lang. Vegeu el paràmetre lang i formatting per format multilingüe (monolingualtext).
 
*<code>value=</code> (opcional) Valor preferent al de Wikidata. Pot ser un paràmetre opcional en una plantilla amb el format <nowiki>{{{paràmetre|}}}</nowiki>, així si existeix pren el valor del paràmetre i si està buit llavors obté el valor de Wikidata.
*<code>formatting=</code> (opcional) Format desitjat. Valors possibles, per a cada tipus:
** <code>value=NONE</code> Amb aquest valor no treu res de Wikidata. Permet configurar un paràmetre per a que no tregui cap valor de Wikidata, o bé treure només valors informats en la plantilla amb <code><nowiki>{{{paràmetre|NONE}}}</nowiki></code>. És equivalent a la sintaxi wiki: <code><nowiki>{{#ifeq:{{{paràmetre|}}}|NONE|<!-- no res -->}}</nowiki></code>.
** Format d'element (''entity''):
*** <code>formatting=raw</code> Número identificador de l'element.
*** <code>formatting=label</code> Etiqueta de l'element.
*** <code>formatting=sitelink</code> Títol de la pàgina de la Viquipèdia de l'element, sense enllaç. Si no existeix retorna el format raw amb el prefix wikidata:.
*** <code>formatting=internallink</code> Enllaç intern sempre que sigui possible, bé a la pàgina de la Viquipèdia (sitelink) o bé a l'etiqueta. Si no existeix l'enllaç a la Viquipèdia de l'element, i existeix una etiqueta, evita l'enllaç per defecte a Wikidata, encara que resulti un enllaç vermell.
*** <code>formatting=''pattern''</code> Format segons un patró usant $1 com a paràmetre a substituir.
**: Pot incloure plantilles o funcions parser amb el format: {{tl|((}}nom-de-la-plantilla<nowiki>{{!}}</nowiki>$1{{tl|))}} o bé {{tl|((}}nom-de-la-plantilla<nowiki>{{!}}</nowiki>nom_paràmetre{{tl|1==}}$1{{tl|))}}, o similar. Només per a valors de tipus text, no en numèrics, dates o coordenades.
*: El format per defecte és un enllaç conduït, bé a ''sitelink'' o bé a wikitada:''raw'', usant ''label'' com a etiqueta de l'enllaç.
*:* <code>formatting=ucfirst</code> Variant del format per defecte amb majúscula inicial en l'etiqueta. En una llista només posa majúscula en el primer element.
*:* <code>formatting=ucinternallink</code> Variant del format "ucfirst" combinat amb "internallink".
** Format de text (string):
*** <code>formatting=weblink</code> Format d'enllaç extern <nowiki>[http://example.com example.com]</nowiki>
*** <code>formatting=''pattern''</code> Format segons un patró usant $1 com a paràmetre a substituir. Exemple:<code><nowiki>formatting=[http://whc.unesco.org/en/list/$1 $1]</nowiki></code>. Per a propietats que ja hi tenen un enllaç autogenerat per WD, el patró es troba a la pàgina de discussió de la propietat.
** Format numèric (quantity):
*** <code>formatting=unit</code> Format numèric incloent la unitat. Si és diferent a 1 ho posa en plural segons [[Mòdul:Wikidata/Units]].
*** <code>formatting=unitcode</code> Format numèric incloent el codi o l'abreviatura de la unitat. Per un codi diferent al definit a {{P|5061}} es pot afegir a [[Mòdul:Wikidata/Units]].
***: Vegeu més avall el paràmetre <code>convert</code> per a conversió d'unitats.
** Format multilingüe (monolingualtext):
*** <code>formatting=language</code> Codi de llengua en que està escrit el valor del paràmetre, en el cas de paràmetres amb format ''monolingual text'', com ara el {{P|P1448}}.
*** <code>formatting=text</code> Recupera el text en brut, sense la marca de llengua. Per defecte s'inclou la marca de llengua quan és diferent a la llengua local del wiki: <code><nowiki><span lang="en">United...</span></nowiki></code>.
*** <code>formatting=''pattern''</code> Format segons un patró usant $language i $text com a variables a substituir. Per exemple, "formatting=($language) $text" per treure el text amb el codi de llengua al davant entre parèntesis.
*** <code>list=lang</code> Sols treu els valors corresponents a la llengua definida o la llengua per defecte. Vegeu el paràmetre lang.
** Format coordenades (globecoordinate):
*** <code>formatting=latitude</code> Valor de latitud en una declaració de coordenades, en format decimal
*** <code>formatting=longitude</code> Valor de longitud en una declaració de coordenades, en format decimal
*** <code>formatting=globe</code> (per defecte) Valor del paràmetre globe amb el format usat en la plantilla {{tl|coord}}, necessari per coordenades fora de la Terra.
*** <code>formatting=$lat...$lon...$globe</code> Format lliure amb paràmetres $lat i $lon, i opcionalment $globe, a substituir pels valors de latitud i longitud, en format decimal, més globe. Admet la inclusió de plantilles.
*** <code>formatting=dimension</code> Valor de dimensió en una declaració de coordenades, en metres, equivalent al [[w:Viquiprojecte:Coordenades geogràfiques#dim:D|paràmetre dim de GeoHack]].
** Format de dates (time):
*** <code>formatting= ''format #time''</code> Accepta qualsevol format vàlid de la [[mw:Help:Extension:ParserFunctions/ca#.23time|funció d'analitzador #time]]. Per exemple: formatting=d-m-Y ({{#time:d-m-Y}}), <nowiki>formatting=[[j xg]]</nowiki> ({{#time:[[j xg]]}}), <nowiki>formatting=Y</nowiki> ({{#time:Y}}). Per defecte usa el format "j F Y" ({{#time:j F Y}})
** Format de taula de propietat i qualificadors:
*** <code>formatting=table</code> Taula de valors de llista de propietats amb els seus qualificadors. Es pot indicar el format de cada línia i de cada columna de la taula. Els separadors són per defecte salts de línia (vegeu ''separator'' i ''conjunction''). Paràmetres específics per a aquest format:
**** <code>qualifier2 ... qualifier''x''=</code> Qualificadors addicionals al primer <code>qualifier</code>, amb nombre il·limitat de valors consecutius.
***** <code>qualifier''x'' = P''nnn1'' OR P''nnn2''</code> Definició alternativa d'un qualificador quan el primer no existeix. Un cas d'ús típic és {{P|P585}} OR {{P|P580}}. No hi ha límit per successius OR. Els espais en blanc d'abans i després són opcionals.
***** <code>qualifier''x'' = P''nnn1''/P''nnn2''</code> Propietat superior P''nnn2'' de l'element corresponent a P''nnn1'' sent aquest un dels qualificadors o la propietat. Amb un valor buit de P''nnn1'' (qualifier''x'' = /P''nnn2'') obté una segona propietat del mateix element. Permet obtenir dades addicionals definides en l'element corresponent. Per exemple, per obtenir les línies de metro amb la seva icona: qualifier=P81/P154. Es pot combinar amb l'opció OR prenent prioritat l'OR.
**** <code>rowformat=</code> Format de la fila de propietat més qualificadors. La propietat s'indica amb $0 i els qualificadors $1 a $x. Per defecte és <code>rowformat=$0 ($1, ... $x)</code>. Pot incloure marques de llistes * o # i també plantilles o funcions parser amb el format: {{tl|((}}plantilla{{tl|!}}paràmetre{{tl|!}}nom{{tl|1==}}paràmetre{{tl|))}}
**** <code>rowsubformat1 ... rowsubformat''x''=</code> Subformat opcional a aplicar a $1-$x definits en rowformat. Pot ser útil per no trencar el format en cas d'un qualificador buit. Per exemple, "rowformat=$0 $1" i "rowsubformat1=per $1" resulta "$0 per $1" o bé "$0" sense qualificador.
**** <code>colformat0 ... colformat''x''=</code> Format opcional a aplicar a les columnes, 0 per la propietat i 1-x pels qualificadors. Accepta la mateixa sintaxi que <code>formatting</code> per a cada tipus de valor.
**** <code>case0 ... case''x''=</code> Cas gramatical a aplicar a cada columna. Vegeu més avall. El paràmetre <code>case</code>, sense numeració, s'aplica a tots els valors.
**** <code>convert0 ... convert''x''=</code> Conversió d'unitats a aplicar a cada columna. Vegeu més avall el paràmetre general <code>convert</code>.
**** <code>whitelist0 ... whitelist''x''=</code> Llista, separada per una barra vertical (/), dels ítems a mostrar per a una columna.
**** <code>blacklist0 ... blacklist''x''=</code> Llista, separada per una barra vertical (/), dels ítems que no es mostraran per a una columna. En cas d'usar whitelist per a una columna i blacklist per a una altra els resultats poden ser inesperats (vegeu un [https://ca.wikipedia.org/w/index.php?title=Tema:Ujnttzn0w9k1x0vq&topic_showPostId=ujsb7o283btc0pix#flow-post-ujsb7o283btc0pix comentari al respecte])
**** <code>tablesort=</code> amb valors de 0 a x, permet ordenar la taula per la propietat (0) o els qualificadors (1 a x). Accepta múltiples claus separant-les amb <code>/</code>. Ex:<code>tablesort=0/2/1</code>. Per defecte l'ordenació és pel rang de la propietat (preferent, normal, obsolet) i per l'antiguitat de definició a Wikidata.
**** <code>sorting=-1</code> inverteix l'ordenació fent-la descendent. Amb qualsevol altre valor, o en el seu defecte, l'ordenació és ascendent. En cas de <code>tablesort </code>amb múltiples claus, el criteri de <code>sorting</code> s'aplicarà a totes per igual.
**** <code>list=false</code> (vegeu més amunt) treu només la primera fila de la taula, segons l'ordre indicat o per defecte.
 
*<code>references=</code> (opcional) Amb qualsevol valor mostrarà les referències del valor obtingut. Si troba {{P|P854}} més o bé {{P|P1476}} o bé {{P|P248}} llavors ho formata amb la versió local de {{Q|Q5637226}} i amb els paràmetres traduïts a la taula i18n["cite"] de [[Module:{{ROOTPAGENAME}}/i18n]]. Si troba {{P|P1433}}, més títol o afirmat, llavors ho formata amb {{Q|Q5624899}}. En cas contrari ho formata com a text.
* <code>separator=</code> (opcional) Separador a usar en llistes o taules. En cas de llistes, per defecte és [[MediaWiki:Comma-separator]], en català una coma i un espai en blanc ', '. En cas de taules per defecte és un salt de línia <nowiki><br /></nowiki>. En algun cas, si s'inclou en etiquetes que usen [[mw:Strip marker|strip markers]], pot ser que un <nowiki><br /></nowiki> no funcioni. L'alternativa és usar separator=LF per a un caràcter de control [[w:salt de línia|line feed]].
*: En cas d'usar-ho amb formatting=table (vegeu [[#Paràmetres de taula de propietat i qualificadors|més avall]]) cal definir on han d'aparèixer les referències en el paràmetre "rowformat".
* <code>conjunction=</code> (opcional) Conjunció a usar com a separador diferent entre els dos últims elements de la llista. Per defecte és igual a separator si està definit i si no és [[MediaWiki:And]] més [[MediaWiki:Word-separator]], en català ' i '. En el cas de taules per defecte és un salt de línia <nowiki><br /></nowiki>
 
*<code>list=</code> (opcional):
* <code>convert=''Qid''</code> (opcional) Per a dades amb format numèric, fa una conversió a la unitat indicada pel seu indicador d'element ''Qid''. Les conversions es fan segons els factors indicats en la unitat obtinguda per la unitat Qid en les propietats {{P|P2370}} o {{P|P2442}}, excepte per a temperatures on s'usen fórmules de conversió entre ºC, ºF i ºK. Per exemple, un valor de "74 polzades" amb convert=Q174728 ({{Q|Q174728}}) dóna "188 centímetres" segons la conversió "2,54 centímetre" indicada a {{Q|Q218593}}. L'arrodoniment de la conversió es fa mantenint la precisió per defecte del valor original segons el nombre de xifres significatives. Es pot combinar amb formatting=unitcode. Es pot usar també amb formatting=table, vegeu més amunt.
** <code>list=true</code> (per defecte) Mostra una llista de tots els valors (vegeu ''separator'' i ''conjuction'' més avall).
** <code>list=false</code> o <code>list=no</code> Mostra només un valor, el de rang més alt segons l'ordre preferent/normal/obsolet, o el més antic dels que tenen el rang més alt.
** <code>list=firstrank</code> Mostra una llista dels valors amb el rang més alt. És equivalent a list=true si tots tenen el mateix rang. És equivalent a list=false si només hi ha un valor amb el rang més alt.
** <code>list=lang</code> En cas de valors monolingües només treu els corresponents a la llengua del paràmetre lang. Vegeu el paràmetre lang i el formatting pel tipus de valor monolingüe (monolingualtext).
** <code>tablesort=0</code> (opcional) ordenació ascendent de la llista. Per defecte l'ordenació és pel rang (preferent, normal, obsolet) i per l'antiguitat de definició a Wikidata.
 
* <code>separator=</code> (opcional) Separador a usar en llistes o taules. En cas de llistes, per defecte és [[MediaWiki:Comma-separator]], en català una coma i un espai en blanc ',&nbsp;'. En cas de taules per defecte és un salt de línia <nowiki><br /></nowiki>. En algun cas, si s'inclou en etiquetes que usen [[mw:Strip marker|strip markers]], pot ser que un <nowiki><br /></nowiki> no funcioni. L'alternativa és usar separator=LF per a un caràcter de control [[w:salt de línia|line feed]].
 
* <code>conjunction=</code> (opcional) Conjunció a usar com a separador diferent entre els dos últims elements de la llista. Per defecte és igual a separator si està definit i si no és [[MediaWiki:And]] més [[MediaWiki:Word-separator]], en català ' i '. En el cas de taules per defecte és un salt de línia <nowiki><br /></nowiki>.
 
*<code>case=</code> (opcional) Cas gramatical a generar., Casosdepenent de la llengua local, o canvis a aplicar en el wiki local definits a [[Module:{{ROOTPAGENAME}}/i18n]]. Com a casos generals tractats pel mòdul:
** case=gender, segons la definició de {{P|21}} de l'element (pàgina actual, item o itemgender) treu el valor de {{P|P2521}}.
** case=infoboxlabel, treu l'etiqueta sense complement amb preposicions i altres correccions definides a [[Mòdul:Wikidata/labels]] en la taula infoboxlabels. Es pot combinar amb itemgender per afegir-hi a més el case=gender.
** case=infoboxdata, per a canvis en l'etiqueta de l'enllaç en valors d'una infotaula, per exemple per usar un àlies més simple o les sigles de forma més apropiada per a una infotaula. Els canvis es defineixen a la taula infoboxdata del [[Mòdul:Wikidata/labels]]. Cal considerar abans si caldria modificar l'etiqueta a Wikidata.
** case=smallcaps, treu l'etiqueta en versaleta.
*: Vegeu la documentació de [[Module:{{ROOTPAGENAME}}/i18n]] per a altres casos locals.
 
*<code>itemgender=</code> (opcional) Element on es comprova {{P|21}} per aplicar la forma femenina si fos necessari, per defecte <code>item</code>. S'usa en combinació amb case=gender o case=infoboxlabel.
*<code>item=</code> (opcional) Permet indicar un item (Qnnnnn) diferent a l'article actiu. Cal fer-lo servir <u>amb moderació</u> pel seu <u>alt consum</u> de recursos. Es pot usar també com a paràmetre global en la plantilla o la invocació superior.
 
*<code>editicon=</code> (opcional) Defineix si es posa alguna icona. Per defecte és ''true''. Amb valors editicon=false o editicon=no és ''false''. Les icones poden ser: una icona d'etiqueta [[File:Noun Project label icon 1116097 cc mirror.svg|10px|baseline|Tradueix|link=d:Q12069631]] en cas que l'etiqueta no s'hagi trobat en la llengua demanada, i un petit llapis [[File:Arbcom ru editing.svg|10px|baseline|Modifica|link=d:Q12069631#P31]] com a icona per mostrar i poder editar la declaració a Wikitada (en el futur gestionat per [[mw:Wikidata Bridge]]). La icona del llapis es mostrarà si està definida en la configuració pel wiki a [[Module:{{ROOTPAGENAME}}/i18n]] amb el valor ["addpencil"] = true.
*<code>itemgender=</code> (opcional) Element on es comprova la forma femenina segons {{P|21}}, per defecte <code>item</code>. S'usa en combinació amb case=gender o case=infoboxlabel.
 
*<code>lang=</code> (opcional) Permet indicar el codi d'una llengua determinada. Es pot usar també com a paràmetre global en la plantilla o la invocació superior. Per defecte usa la llengua local del wiki per a l'espai principal d'articles o la llengua d'usuari definida en les preferències per a altres espais de noms. Si no troba el valor en aquesta llengua ho intenta en les llengües alternatives definides en el MediaWiki. Per exemple per català les llengües alternatives són occità i anglès. En cas que el valor no s'hagi trobat en la llengua demanada, hi afegeix un petit llapis com a icona per a traduir-ho a Wikidata. Aquesta icona es pot eliminar amb el paràmetre editicon.
 
*<code>editicon=</code> (opcional) Defineix si es posa un petit llapis [[File:Arbcom ru editing.svg|12px|Tradueix|link=d:Q12069631]] com a icona per editar a Wikitada en cas que el valor no s'hagi trobat en la llengua demanada. Per defecte és ''true''. Amb valors editicon=false o editicon=no és ''false''.
 
*<code>showerrors=</code> (opcional) Amb qualsevol valor mostra el missatge d'error, si n'hi ha cap. Si no està definit mostrarà el paràmetre default en cas d'error.
Linha 101 ⟶ 60:
*<code>default=</code> (opcional) Text a mostrar en cas d'error. No té cap efecte si està definit el paràmetre showerrors. Si no està definit, i tampoc el paràmetre showerrors, retornarà un valor buit en cas d'error.
 
*<code>sandbox=</code> (opcional) Amb qualsevol valor desvia les crides al [[Module:{{ROOTPAGENAME}}/proves]]. El títol de la subpàgina l'obté de [[MediaWiki:Sandboxlink-subpage-name]], en català "proves". El paràmetre es pot usar en l'entorn de plantilla. Com a paràmetre d'invoke o de require no té sentit per les proves. A usar només provisionalment o en previsualització, el mòdul de proves no hauria de tenir cap enllaç permanent.
*<code>references=</code> (opcional) Amb qualsevol valor mostrarà les referències del valor obtingut.
 
=== Paràmetres de formatació ===
<code>formatting=</code> (opcional) Format desitjat. Valors possibles, per a cada tipus de dada:
 
Dada amb valor d'element (''entity''):
* <code>formatting=raw</code> Número identificador de l'element.
* <code>formatting=label</code> Etiqueta de l'element en la llengua demanada, alguna de les llengües alternatives o bé com a ''raw''.
* <code>formatting=sitelink</code> Títol de la pàgina de la Viquipèdia de l'element, sense enllaç. Si no existeix retorna el format raw amb el prefix d:.
* <code>formatting=internallink</code> Enllaç intern sempre que sigui possible, bé a la pàgina de la Viquipèdia (sitelink) o bé a l'etiqueta (possiblement un enllaç vermell). Com a darrera opció enllaça a Wikidata.
* <code>formatting=''pattern''</code> Format segons un patró usant $1 com a paràmetre a substituir. Pot incloure plantilles o funcions parser amb el format: {{tl|((}}nom-de-la-plantilla<nowiki>{{!}}</nowiki>$1{{tl|))}} o bé {{tl|((}}nom-de-la-plantilla<nowiki>{{!}}</nowiki>nom_paràmetre{{tl|1==}}$1{{tl|))}}, o similar.
: El format per defecte és un enllaç conduït, bé a ''sitelink'' o bé a wikitada:''raw'', usant ''label'' com a etiqueta de l'enllaç.
:* <code>formatting=ucfirst</code> Variant del format per defecte amb majúscula inicial en l'etiqueta. En una llista només posa majúscula en el primer valor.
:* <code>formatting=ucinternallink</code> Combinació del format "ucfirst" i "internallink".
 
Dada amb valor de text (''string''):
: General:
:* <code>formatting=''pattern''</code> Format segons un patró usant $1 com a paràmetre a substituir. Exemple: <code><nowiki>formatting=[http://whc.unesco.org/en/list/$1 $1]</nowiki></code>. Per a propietats d'identificador que tenen un enllaç autogenerat per Wikidata, el patró es troba a la pàgina de discussió de la propietat. Pot incloure plantilles i funcions parser (vegeu més amunt per ''entity'').
: Tipus URL:
:* <code>formatting=weblink</code> Format d'enllaç extern, posant com a etiqueta el lloc web sense prefixos i amb punts suspensius si enllaça a una pàgina web: <nowiki>[http://www.example.com example.com], [http://example.com/en/page example.com…]</nowiki>.
: Tipus identificador extern (''external-id''):
:* <code>formatting=externalid</code> Format d'enllaç extern amb el patró de l'URL definit a {{P|P1630}} en l'entitat Pid de <code>property</code>.
: Tipus fórmula matemàtica (''math''):
:: El contingut s'engloba amb l'etiqueta <nowiki><math></nowiki> que genera una imatge de la fórmula. Vegeu [[mw:Extension:Math]] i exemples a {{P|P2534}}.
: Tipus notació musical (''musical-notation''):
:: El contingut s'engloba amb l'etiqueta <nowiki><score></nowiki> que genera una imatge de la partitura. Vegeu [[mw:Extension:Score]] i exemples a {{P|P6686}}. Opcions de format:
:* <code>formatting=sound</code> Afegeix l'atribut sound="1" a l'etiqueta generant un fitxer d'àudio que s'incrusta sota la imatge.
 
Dada amb valor numèric (''quantity''):
: Per defecte mostra només el número.
* <code>formatting=unit</code> Format numèric incloent la unitat. Si és diferent a 1 ho posa en plural segons [[Module:{{ROOTPAGENAME}}/Units]].
* <code>formatting=unitcode</code> Format numèric incloent el codi o l'abreviatura de la unitat definit a {{P|5061}}. Es pot canviar a [[Module:{{ROOTPAGENAME}}/Units]]. Si no el troba usa el nom de la unitat.
* <code>convert=''Qid''</code> Fa una conversió a la unitat indicada pel seu indicador d'element ''Qid''. Les conversions es fan segons els factors indicats en la unitat obtinguda per la unitat Qid en les propietats {{P|P2370}} o {{P|P2442}}, excepte per a temperatures on s'usen fórmules de conversió entre ºC, ºF i ºK. Per exemple, un valor de "74 polzades" amb convert=Q174728 ({{Q|Q174728}}) dóna "188 centímetres" segons la conversió "2,54 centímetre" indicada a {{Q|Q218593}}. L'arrodoniment de la conversió es fa mantenint la precisió per defecte del valor original segons el nombre de xifres significatives. Es pot combinar amb formatting=unitcode. Es pot usar també amb formatting=table, vegeu més avall.
* <code>convert=default</code> Fa una conversió de les unitats indicades en la taula convert_default de [[Module:{{ROOTPAGENAME}}/Units]].
* <code>convert=default2</code> Variant que mostra els dos valors: amb la quantitat convertida i entre parèntesis la quantitat original.
* <code>convert=M</code> Fa una conversió a milions, arrodonint sense decimals, si la quantitat és major que 100 milions. Afegeix M davant de la unitat o el codi, per exemple Meuro, M$.
 
Dada amb valor monolingüe (''monolingualtext''):
* <code>formatting=language</code> Retorna el codi de llengua corresponent al valor monolingüe, per exemple en el cas de {{P|P1448}}.
* <code>formatting=text</code> Recupera el text amb la marca de llengua, si és diferent a la llengua local del wiki: <code><nowiki><span lang="en">United...</span></nowiki></code>.
* <code>formatting=''pattern''</code> Format segons un patró usant $language i $text com a variables a substituir. Per exemple, "formatting=($language) $text" per treure el text amb el codi de llengua al davant entre parèntesis.
* <code>list=lang</code> Sols treu els valors corresponents a la llengua definida o la llengua per defecte. Vegeu el paràmetre lang més amunt.
 
Dada amb valor de coordenades (''globecoordinate''):
* <code>formatting=latitude</code> Valor de latitud en una declaració de coordenades, en format decimal
* <code>formatting=longitude</code> Valor de longitud en una declaració de coordenades, en format decimal
* <code>formatting=globe</code> (per defecte) Valor del paràmetre globe amb el format usat en la plantilla {{tl|coord}}, necessari per coordenades fora de la Terra.
* <code>formatting=$lat...$lon...$globe</code> Format lliure amb paràmetres $lat i $lon, i opcionalment $globe, a substituir pels valors de latitud i longitud, en format decimal, més globe. Admet la inclusió de plantilles en format no expandit, p. ex. {{tl|((}}coord<nowiki>{{!}}</nowiki>$lat<nowiki>{{!}}</nowiki>$lon{{tl|))}}.
* <code>formatting=dimension</code> Valor de dimensió en una declaració de coordenades, en metres, equivalent al [[w:Viquiprojecte:Coordenades geogràfiques#dim:D|paràmetre dim de GeoHack]].
 
Dada amb valor de data (''time''):
: Per defecte usa el format definit a [[Module:{{ROOTPAGENAME}}/i18n]] en la taula datetime segons la precisió de la data. Opcionalment, per precisió de dies:
* <code>formatting= ''sintaxi #time''</code> Accepta qualsevol format vàlid de la [[mw:Help:Extension:ParserFunctions#.23time|funció d'analitzador #time]]. Per exemple: formatting=d-m-Y ({{#time:d-m-Y}}), <nowiki>formatting=[[j xg]]</nowiki> ({{#time:[[j xg]]}}), <nowiki>formatting=Y</nowiki> ({{#time:Y}}). Per defecte, està definit a [[Module:{{ROOTPAGENAME}}/i18n]] com "j F Y" ({{#time:j F Y}}), però amb una funció que permet modificar el dia 1r de cada mes.
: Hi afegeix el calendari quan pot ser ambigu: si la data és anterior al 15-10-1582 i està definida en gregorià o si és posterior al 4-10-1582 i està definida en julià. Vegeu [[w:calendari gregorià|calendari gregorià]] per a més informació.
 
=== Paràmetres de taula de propietat i qualificadors ===
{| class="wikitable" style="float:right;"
! !! propietat !! qualificador1 !! qualificador2 etc.
|-
! valors 1a declaració
| $0 || $1 || $2, etc.
|-
! 2a, etc.
| $0 || $1 || $2, etc.
|}
<code>formatting=table</code> Una declaració amb qualificadors es considera com una taula de valors mostrada a la dreta. Es pot indicar el format de les files i de cada columna de la taula. Els separadors per a cada fila són per defecte salts de línia (vegeu ''separator'' i ''conjunction'' més amunt). Si realment voleu el resultat en una taula wiki podeu usar separator=<nowiki></tr><tr></nowiki> amb les corresponents etiquetes d'apertura i tancament abans i desprès de l'invoke. Paràmetres específics per a aquest format:
 
Columnes:
* <code>qualifier1 ... qualifier''x''=</code> Qualificadors amb un número consecutiu i il·limitat. El paràmetre general <code>qualifier</code> és un àlies per qualifier1.
** <code>qualifier''x'' = P''id1'' OR P''id2''</code> Definició alternativa d'un qualificador quan el primer no existeix. Un cas d'ús típic és {{P|P585}} OR {{P|P580}}. No hi ha límit per successius OR. Els espais en blanc d'abans i després són opcionals.
** <code>qualifier''x'' = P''id1''/P''id2''</code> De l'element corresponent a P''id1'' (un qualificador o una propietat) obté la propietat superior P''id2''. Permet obtenir dades addicionals en la taula encara que definides en l'element superior. Per exemple, per obtenir les línies de metro amb la seva icona: qualifier=P81/P154. Es pot combinar amb l'opció OR prenent prioritat l'OR.
** <code>qualifier''x'' = /P''id''</code> Equivalent a l'anterior però sense P''id1'', obté una segona propietat del mateix element. Permet obtenir dades definides bé en un qualificador o bé en una propietat.
* <code>colformat0 ... colformat''x''=</code> Format opcional a aplicar a les columnes, usant 0 per la propietat i 1-x pels qualificadors. Accepta la mateixa sintaxi que <code>formatting</code> per a cada tipus de dada. Vegeu més amunt [[#Paràmetres de formatació]].
* <code>case0 ... case''x''=</code> Cas gramatical a aplicar a cada columna. El paràmetre <code>case</code>, sense numeració, s'aplica a tots els valors. Vegeu més amunt [[#Paràmetres generals]].
* <code>convert0 ... convert''x''=</code> Conversió d'unitats a aplicar a cada columna. Vegeu més amunt [[#Paràmetres de formatació]] per format numèric.
* <code>whitelist0 ... whitelist''x''=</code> Llista dels ítems a mostrar per a una columna, usant qualsevol separador.
* <code>blacklist0 ... blacklist''x''=</code> Llista dels ítems que no es mostraran per a una columna, usant qualsevol separador. En cas d'usar whitelist per a una columna i blacklist per a una altra els resultats poden ser inesperats (vegeu un [https://ca.wikipedia.org/w/index.php?title=Tema:Ujnttzn0w9k1x0vq&topic_showPostId=ujsb7o283btc0pix#flow-post-ujsb7o283btc0pix comentari al respecte])
 
Files:
* <code>rowformat=</code> Format de les files de propietat més qualificadors. La propietat s'indica amb $0 i els qualificadors $1 a $x. Per defecte és <code>rowformat=$0 ($1, ... $x)</code>. Pot incloure marques de llistes * o # i també plantilles o funcions parser amb el format: {{tl|((}}plantilla<nowiki>{{!}}</nowiki>paràmetre<nowiki>{{!}}</nowiki>nom{{tl|1==}}paràmetre{{tl|))}}. En cas d'usar el paràmetre "references" (vegeu [[#Paràmetres generals|més amunt]]) cal indicar on han d'aparèixer les referències amb $R0.
* <code>rowsubformat1 ... rowsubformat''x''=</code> Format previ a aplicar a $1-$x definits en rowformat, només si existeix el valor. Per exemple, "rowformat=$0 $1" i "rowsubformat1=($1)" resulta "$0 ($1)" o bé "$0" si $1 està buit, evitant uns parèntesis buits. Un rowsubformat pot contenir diferents variables $1-$x. Cal tenir en compte que les substitucions en fan de forma seqüencial per ordre numèric, per tant pot incloure un $x posterior però no un d'anterior ja que haurà estat tractat.
* <code>tablesort=</code> amb valors de 0 a x, permet ordenar la taula per la propietat (0) o els qualificadors (1 a x). L'ordenació és ascendent alfabèticament, numèricament o per dates, segons el tipus de dada. Accepta múltiples claus usant qualsevol separador, p. ex. <code>tablesort=0/2/1</code>. Per defecte l'ordenació és pel rang de la propietat (preferent, normal, obsolet) i per l'antiguitat de definició a Wikidata.
* <code>sorting=-1</code> inverteix l'ordenació fent-la descendent. Amb qualsevol altre valor, o en el seu defecte, l'ordenació és ascendent. En cas de <code>tablesort</code> amb múltiples claus, el criteri de <code>sorting</code> s'aplicarà a totes per igual.
* <code>list=false</code> Treu només la primera fila de la taula, segons l'ordre indicat o l'ordre per defecte.
 
== Funció getLabel ==
Retorna l'etiqueta d'un element.
* <code>1=</code> (primer paràmetre posicional, requerit) Identificador de l'ítem de Wikidata (Qxxx o Pxxx).
* <code>1=</code> (primer paràmetre posicional, requerit) Identificador de l'ítem de Wikidata (Qid o Pid). Àlies: <code>item</code>, <code>from</code>.
* <code>lang=</code> (opcional) Codi de llengua. Per defecte és la llengua del wiki en l'espai principal d'articles o la llengua de les preferències de l'usuari en altres espais. Si no troba l'etiqueta llavors la cerca en les llengües alternatives definides per MediaWiki. Per exemple per català les alternatives són primer occità i finalment anglès. Si tampoc la troba en les llengües alternatives retornarà l'ID de Wikidata (el primer paràmetre).
* <code>lang=</code> (opcional) Codi de llengua, com en la funció claim. Vegeu més amunt [[#Paràmetres generals]].
* <code>itemgender=</code> (opcional) Identificador de l'ítem que determina el gènere a usar. En cas que sigui gènere femení retornarà l'etiqueta definida a {{P|P2521}}, si existeix en la llengua corresponent.
* <code>fixeditemgender=</code> (opcional) AmbIdentificador qualsevolde valor,l'ítem ique endetermina casel quegènere langa siguiusar, lacom llenguaen localla delfunció wiki,claim. obtéVegeu l'etiquetamés fixada aamunt [[Mòdul:Wikidata/labels#Paràmetres generals]] en la taula infoboxLabelsFromId.
* <code>linked=</code> (opcional) Amb qualsevol valor, definitexcepte retornarà'no', retorna l'etiqueta enllaçada a l'article local o bé a Wikidata.
* <code>label=</code> (opcional) Treu l'etiqueta indicada. Només té sentit amb linked= per generar un enllaç amb l'etiqueta de label=.
* <code>editicon=</code> (opcional) Defineixpermet sieliminar esla posaicona un petitdel llapis [[File:Arbcom ru editing.svg|12px|Tradueix|link=d:Q12069631]], com a icona per editar a Wikitada en cas que l'etiqueta no s'hagi trobat en la llenguafunció demanadaclaim. PerVegeu defectemés ésamunt ''true''.[[#Paràmetres Amb valors editicon=false o editicon=no és ''false''generals]].
 
== Funció getParentValues ==
Retorna de forma recursiva valors d'una propietat usant com a etiqueta un valor superior. Per exemple pot estraure l'estructura administativa o la classificació de tàxons.
* <code>item=</code> (opcional) Permet indicar un item (Qnnnnn) diferent a l'article actiu. Aquest accés arbitrari a Wikidata està limitat pel seu alt consum de recursos.
* <code>propertyitem=</code> (opcional) PropietatPermet deindicar laun declaració,item amb(Qid) formatdiferent "P"a seguit dl'unarticle númeroactiu. PerAquest defecteaccés ésarbitrari {{P|131}}.a AdmetWikidata unaestà llistalimitat depel valorsseu alternatiusalt separatsconsum per un espai en blanc o una barrade inclinadarecursos.
* <code>labelproperty=</code> (opcional) Propietat de l'etiquetala declaració (Pid). Per defecte és {{P|31131}}. Admet una llista de valors alternatius usant qualsevol separador.
* <code>valuetextlabel=</code> (opcional) Propietat delsuperior texta deusar l'enllaçcom dela valoretiqueta. Per defecte és un enllaç intern (vegeu formatting=internallink més amunt){{P|31}}.
* <code>upto=</code> (opcional) FinsDarrera oniteració volema profunditzar en l'arbre de consultesextraure, si abans no trobiha trobat cap més propietat no existent. Tipus de valors:
** upto=''etiqueta'': últimadarrera etiqueta a consultar, per exemple "upto=estat".
** upto=''valor numèric'': nombre de nivells màxim a extreured'iteracions. Per defecte és 10 com a protecció, normalment un valor més alt del que serà necessari.
* <code>uptolinkiduptolabelid=</code> (opcional) Alternatiu a <code>upto=''etiqueta''</code> ambusant unel Qid. Admet valors múltiples separats per un blanc o una barra inclinada.
* <code>uptovalueid=</code> (opcional) Alternatiu a <code>uptolabelid</code> usant el Qid del valor en lloc de l'etiqueta. Admet valors múltiples usant qualsevol separador. Àlies uptolinkid mantingut provisionalment per compatibilitat.
* <code>labelshow=</code> (opcional) Filtre d'etiquetes a mostrar, separades per una barra / si són més d'una. Per exemple "labelshow=municipi/comarca". Mostra el primer valor trobat per a cada etiqueta, sense repeticions posteriors de la mateixa etiqueta.
* <code>showlabelid=</code> (opcional) Alternatiu a <code>labelshow</code> usant Qid i qualsevol separador.
* <code>include_self=true</code> (opcional) Inclou l'etiqueta de la pròpia pàgina en la llista de sortidagenerada.
* <code>sorting=-1</code> (opcional) Ordenació descendent de la llista. Només té un valor possible "sorting=-1" per ordenar de forma inversa.
* <code>last_only=true</code> (opcional) Només mostra el darrer valor obtingut. Per exemple amb uptolinkid=QxxQid només mostrarà el valor corresponent a QxxQid.
* <code>formatting=</code> (opcional) Format del valor de la propietat. Per defecte és un enllaç conduït local o a Wikidata (vegeu més amunt [[#Paràmetres de formatació|formatting]] de la funció claim per valors ''entity'').
* <code>valuetext=</code> (opcional) Propietat a usar com a text de l'enllaç amb el valor 'property' com a enllaç conduït.
* <code>labelformat=</code> (opcional) Format de l'etiqueta. Per defecte és "label" (vegeu més amunt [[#Paràmetres de formatació|formatting]] de la funció claim per valors ''entity'').
* <code>rowformat=</code> (opcional) Format de sortida per a cada parell de valors obtingut, indicant $0 per l'etiqueta i $1 pel valor. Per defecte és "rowformat=$0 = $1" mostrant per exemple "comarca = <nowiki>[[Maresme]]</nowiki>"
* <code>separator=</code> (opcional) Separador per a cada parell de valors obtingut, per defecte és <nowiki><br /></nowiki>. A notar que no s'utilitza l'opció conjunction pel darrer separador.
* <code>cascade=true</code> (opcional) opció de presentació amb sagnat. Pot ser útil quan només s'utilitza $1 a rowformat.
Nota: les etiquetes de les instàncies es modifiquen amb un format més adequat a les necessitats d'una infotaula segons les definicions a [[Module:{{ROOTPAGENAME}}/labels]]. Per exemple, "municipi del Brasil" es presenta com a "Municipi". A [[Mòdul:Wikidata/labels]] es poden definir les correccions necessàries.
 
== Funció linkWithParentLabel ==
Crea un enllaç amb l'etiqueta d'una propietat superior.
Accepta la majoria de paràmetres de la funció claim, excepte "formatting" que usa el valor per defecte "internallink". Addicionalment:
 
* <code>parent=</code> és la propietat a usar en l'etiqueta corresponent a l'ítem superior del valor obtingut per "property/qualifier".
Accepta la majoria de paràmetres de la funció [[#Funció claim|claim]], excepte "formatting" que usa el valor per defecte "internallink". Addicionalment:
* <code>parent=</code> és la propietat a usar en l'etiqueta corresponent a l'ítem superior del valor obtingut per "property/qualifier". Accepta valors alternatius amb qualsevol separador, igual que el paràmetre "property" de la funció claim.
 
== Funció yearsOld ==
Retorna l'edat avaluant la data de naixement i la data de defunció o en el seu defecte la data actual. Si les dues dates no tenen precisió de dia mostra el rang amb un marge d'1 o de 10 anys.
La seva sintaxi és: <code><nowiki>{{#invoke:Wikidata|yearsOld|formatting=''tipus pattern'' |item= }}</nowiki></code>. <code>item</code> i <code>formatting</code> són opcionals. Un exemple típic de formatting és ''($1 anys)''
 
La seva sintaxi és: <code><nowiki>{{#invoke:</nowiki>{{ROOTPAGENAME}}<nowiki>|yearsOld|formatting= |item= }}</nowiki></code>. Els paràmetres <code>item</code> i <code>formatting</code> són opcionals. Per defecte retorna la quantitat.
* <code>formatting=unit</code> (opcional) Obté la unitat de la taula i18n["years-old"] de [[Module:{{ROOTPAGENAME}}/i18n]] pel singular o el plural, a més de paucal usat en llengües eslaves com el rus. Vegeu la funció parser PLURAL a [[mw:Help:Magic words#Localization]].
* <code>formatting=''pattern''</code> (opcional) Format amb un patró usant $1 com a variable per la quantitat. Un exemple típic és " ($1 anys)". En aquest cas no avalua l'expressió en singular, plural o paucal i obté la unitat de {{Q|Q24564698}}. Una alternativa és usar un patró uniforme definit en la taula i18n["years-old"] que admet el paràmetre $1.
 
== Utilitats ==
* <code>getSiteLink</code> Retorna el títol de pàgina local per un element donat. Sintaxi:
*: <code><nowiki>{{#invoke:</nowiki>{{ROOTPAGENAME}}<nowiki>|getSiteLink|<Qid>|<wiki>}}</nowiki></code>
*: Sense cap paràmetre retorna la pròpia pàgina. Proporcionant l'id retornarà la pàgina local enllaçada en l'element corresponent. En cas de no existir o ser erroni no retorna res. Amb un segon paràmetre amb un codi de wiki obté la pàgina en el wiki especificat (enwiki, frwiki,... cawiktionary, etc.)
 
* <code>lang</code> Retorna el codi de llengua tal com el gestiona la funció claim. Vegeu [[#Paràmetres generals]] més amunt. Sintaxi:
*: <code><nowiki>{{#invoke:</nowiki>{{ROOTPAGENAME}}<nowiki>|lang|{{{lang|}}}}}</nowiki></code>
*: El paràmetre <code>lang</code> és el codi de la llengua aportat explícitament.
 
* <code>numStatements</code> Retorna el nombre d'instàncies que té una propietat multi-valor. Permet decidir el tractament a donar a llistes llargues. Sintaxi:
*: <code><nowiki>{{#invoke:</nowiki>{{ROOTPAGENAME}}<nowiki>|numStatements|<Pid>|item={{{item|}}}</nowiki></code>
*: Exemple: <nowiki>{{#invoke:</nowiki>{{ROOTPAGENAME}}<nowiki>|numStatements|P47|item=Q1861}}</nowiki> → {{#invoke:{{ROOTPAGENAME}}|numStatements|P47|item=Q1861}}
 
* <code>validProperty</code> Retorna "null" si la propietat no existeix, o només té valors amb marcador "sense valor" o "valor desconegut" o obsolet. Sintaxi:
*: <code><nowiki>{{#invoke:<nowiki>{{ROOTPAGENAME}}<nowiki>|validProperty|<Pid>|item={{{item|}}}</nowiki></code>
*: Es pot usar com a alternativa a #property. Per compatibilitat amb aquesta funció parser, el paràmetre <code>from</code> és un àlies de <code>item</code>.
 
* Per a funcions de depuració vegeu [[Module:{{BASEPAGENAME}}/debug]].
 
== Redireccions a Wikidata ==
 
Un element de Wikidata pot ser una redirecció a un altre element, sovint com a resultat d'una fusió. Els valors d'una propietat poden ser provisionalment una redirecció, normalment corregit per bot al cap d'una setmana. El tractament de les redireccions és el següent:
* Funció claim
** Amb formatting=raw no retorna el Qid redirigit sinó el Qid final de la redirecció.
** Amb paràmetres whitelist o blacklist, si la llista de valors inclou alguna redirecció, considera tant el Qid redirigit com el nou Qid final.
* Funció getLabel
** Si es demana l'etiqueta d'un Qid redirigit, la buscarà en el Qid final.
En tots els casos afegeix un rastreig per poder corregir en les plantilles els Qid redirigits. Es poden trobar a [[Special:WhatLinksHere/Template:Track/wikidata/redirect]].
 
La resolució de redireccions a Wikidata està pendent de [[phab:T157868]]. La solució tècnica adoptada provisionalment pot provocar un alt consum de recursos si un element no té cap etiqueta en la llengua local ni en les llengües alternatives. Es recomana comprovar el rastreig [[Special:WhatLinksHere/Template:Track/wikidata/label]] per afegir les etiquetes que manquen.
 
==Crides des d'un altre mòdul==
Totes les funcions (claim, getLabel, getParentValues, linkWithParentLabel, yearsOld, lang) es poden cridar des d'altres mòduls via <code>require</code> amb els mateixos paràmetres proporcionats en una taula, per exemple:
:<nowiki>require("Module:</nowiki>{{ROOTPAGENAME}}<nowiki>").claim{item="Q...", property="P...", ...}</nowiki>
:<nowiki>require("Module:</nowiki>{{ROOTPAGENAME}}<nowiki>").getLabel({"Q...", ['lang']="ca"})</nowiki>
Les funcions claim i getLabel retornen com a segon valor la variable untranslated (nil o true) per a tractament específic en mòduls d'infotaules.
 
== Exemples ==
Els exemples a continuació són mostres provades en les pàgines corresponents. Es poden fer proves a [[w:Viquipèdia:Proves de Wikidata]], comprovacions en previsualització d'una pàgina o usar el paràmetre <code>item</code> per un element de Wikidata diferent de la pàgina actual.
 
*Ús simple:
:<nowiki>{{#invoke:Wikidata</nowiki>{{ROOTPAGENAME}}<nowiki> | claim |property=P20}}</nowiki> a l'article [[Jean-François Champollion]]{{Q|Q260}} dóna: {{#invoke:Wikidata{{ROOTPAGENAME}} | claim |property=P20|item=Q260|showerrors=sip}}
:és la propietat {{P|P20}}, per defecte amb el valor enllaçat.
 
*Sense enllaç:
:<nowiki>{{#invoke:Wikidata</nowiki>{{ROOTPAGENAME}}<nowiki> | claim | property=P20 | formatting=label}}</nowiki> dóna: {{#invoke:Wikidata{{ROOTPAGENAME}} | claim | property=P20 | formatting=label|item=Q260|showerrors=sip}}
 
*Valor preferent:
:<nowiki>{{#invoke:Wikidata</nowiki>{{ROOTPAGENAME}}<nowiki> | claim | property=P20 | value={{{lloc_mort|}}} }}</nowiki> en la infotaula de l'article donarà
:el valor de <nowiki>{{{lloc_mort|}}}</nowiki> si està definit en l'article, en cas contrari [[París]]
 
*Valor tipus data:
:<nowiki>{{#invoke:Wikidata</nowiki>{{ROOTPAGENAME}}<nowiki> | claim | property=P569}}</nowiki> dóna la data de naixement amb el format per defecte:
: {{#invoke:Wikidata{{ROOTPAGENAME}} | claim | property=P569|item=Q260|showerrors=sip}}
 
*Formatat amb un patró:
:<nowiki>{{#invoke:Wikidata</nowiki>{{ROOTPAGENAME}}<nowiki> | claim | property=P214 | formatting=[http://viaf.org/viaf/$1 $1]}}</nowiki> dóna:
:{{#invoke:Wikidata{{ROOTPAGENAME}} | claim | property=P214 | formatting=[http://viaf.org/viaf/$1 $1]|item=Q260|showerrors=sip}}
 
*Un únic valor:
{{#invoke:Wikidata{{ROOTPAGENAME}} | claim | property=P18 | list=false | formatting=[[File:$1|thumb|upright=.5|Imatge de mostra]]|item=Q260|showerrorsediticon=sipfalse}}
:<nowiki>{{#invoke:Wikidata</nowiki>{{ROOTPAGENAME}}<nowiki> | claim | property=P18 | list=false | formatting=[[File:$1|thumb|upright=.5|Imatge de mostra]]}}</nowiki>
:Treu només la primera de les imatges definides.
 
*Format d'enllaç extern:
:<nowiki>{{#invoke:Wikidata</nowiki>{{ROOTPAGENAME}}<nowiki> | claim | property=P856 | formatting=weblink}}</nowiki> a [[Berlín]] dóna:
:{{#invoke:Wikidata{{ROOTPAGENAME}} | claim | property=P856 | formatting=weblink| item=Q64|showerrors=sip}}
 
*Llista de valors:
:<nowiki>{{#invoke:Wikidata</nowiki>{{ROOTPAGENAME}}<nowiki> | claim | property=P47}}</nowiki> a [[Alcoià]]{{Q|Q746061}} dóna:
: {{#invoke:Wikidata{{ROOTPAGENAME}} | claim | property=P47 | item=Q746061 |showerrors=sip}}
:Cal notar l'enllaç conduït <nowiki>[[Comtat (País Valencià)|Comtat]]</nowiki>
 
*Llista formatada:
:<nowiki>{{#invoke:Wikidata</nowiki>{{ROOTPAGENAME}}<nowiki> | claim | property=P150 | separator=<br /> | conjunction=<br />}}</nowiki> dóna
: {{#invoke:Wikidata{{ROOTPAGENAME}} | claim | property=P150 | separator=<br /> | conjunction=<br /> | item=Q746061 |showerrors=sip}}
 
*Coordenades:
:<nowiki>{{#invoke:Wikidata</nowiki>{{ROOTPAGENAME}}<nowiki> | claim | property=P625 | formatting=latitude}}</nowiki> dóna: {{#invoke:Wikidata{{ROOTPAGENAME}} | claim | property=P625 | formatting=latitude | item=Q746061 |showerrors=sip}}
:<nowiki>{{#invoke:Wikidata</nowiki>{{ROOTPAGENAME}}<nowiki> | claim | property=P625 | formatting=longitude}}</nowiki> dóna: {{#invoke:Wikidata{{ROOTPAGENAME}} | claim | property=P625 | formatting=longitude | item=Q746061 |showerrors=sip}}
 
== Dependències ==
* Subpàgines relatives al mòdul principal. El títol del mòdul està definit a la variable <code>module_title = </code>. En una nova instal·lació amb un títol diferent cal modificar aquesta variable.
** [[Module:{{ROOTPAGENAME}}/i18n|../i18n]] (opcional): traduccions de missatges i formats locals. Si s'usa <code>lang</code> diferent al local cerca la subpàgina corresponent, per exemple [[Module:{{BASEPAGENAME}}/i18n/eu|../i18n/eu]]. Si no existeix, surt en anglès per defecte.
** [[Module:{{ROOTPAGENAME}}/Units|../Units]] (opcional): tractament d'unitats, en plural o amb codi. Si no existeix, treu el nom complet de la unitat en singular.
** [[Module:{{ROOTPAGENAME}}/labels|../labels]] (opcional): excepcions i correccions d'etiquetes per a una infotaula.
** [[Module:{{ROOTPAGENAME}}/debug|../debug]]: pot aparèixer ocasionalment per la funció track de manteniment.
* Missatges Mediawiki utilitzats depenent de la llengua:
** [[Mediawiki:Comma-separator]], [[Mediawiki:And]], [[Mediawiki:Word-separator]]
** [[Mediawiki:Wikibase-snakview-snaktypeselector-novalue]], [[Mediawiki:Wikibase-snakview-snaktypeselector-somevalue]]
** [[Mediawiki:Wikibase-time-calendar-gregorian]], [[Mediawiki:Wikibase-time-calendar-julian]]
** [[Mediawiki:Translate-taction-translate]]
** [[MediaWiki:Sandboxlink-subpage-name]]
*: Si és necessari es poden crear, o modificar, a [[m:translatewiki.net|Translatewiki]]. Per accedir-hi directament activeu l'enllaç corresponent amb el títol del missatge i el codi de llengua <code><nowiki>[[translatewiki:MediaWiki:</nowiki>''<missatge>''/''<lang>'']]</code>.
 
==Vegeu també==
* [[mw:Extension:Wikibase Client/Lua|Llibreria mw.wikibase]]. Són les funcions bàsiques que es poden trobar a [[Module:Wikibase]].
 
<includeonly>