Mòdul:Wikidata/ús: diferència entre les revisions
Contingut suprimit Contingut afegit
m 35 revisions importades de w:Mòdul:Wikidata/ús |
actualització de ca.wiki |
||
Línia 1:
Aquest mòdul extrau dades formatades de Wikidata.
== Funcions ==
Funció bàsica:
* <code>claim</code>: Retorna amb un format determinat el valor (o els valors) d'una declaració o del qualificador d'una declaració. Per defecte està referit a l'item (Qnnnn) de l'article actiu.
Altres funcions:
* <code>getLabel</code>: retorna una etiqueta en la llengua especificada, o la llengua per defecte.
* <code>getParentValues</code>: retorna etiquetes i valors superiors d'una propietat de forma recursiva.
* <code>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>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.
* <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 ==
Sintaxi completa:
:<code><nowiki>{{#invoke:Wikidata|claim|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|claim|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:
*<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>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>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>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>formatting=</code> (opcional) Format desitjat. Valors possibles, per a cada tipus:
** 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>
*** <code>formatting=
*** <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=
*** <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
**** <code>qualifier2 ...
***** <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>
**** <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>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]].
* <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>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>case=</code> (opcional) Cas gramatical a generar. Casos definits:
** 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.
*<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>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.
*<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>references=</code> (opcional) Amb qualsevol valor mostrarà les referències del valor obtingut.
== Funció getLabel ==
* <code>1=</code> (primer paràmetre posicional, requerit) Identificador de l'ítem de Wikidata (Qxxx o Pxxx).
* <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>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>fixed=</code> (opcional) Amb qualsevol valor, i en cas que lang sigui la llengua local del wiki, obté l'etiqueta fixada a [[Mòdul:Wikidata/labels]] en la taula infoboxLabelsFromId.
* <code>linked=</code> (opcional) Amb qualsevol valor definit retornarà l'etiqueta enllaçada a l'article local.
* <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) 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 l'etiqueta no s'hagi trobat en la llengua demanada. Per defecte és ''true''. Amb valors editicon=false o editicon=no és ''false''.
== Funció getParentValues ==
* <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>property=</code> (opcional) Propietat de la declaració, amb format "P" seguit d'un número. Per defecte és {{P|131}}. Admet una llista de valors alternatius separats per un espai en blanc o una barra inclinada.
* <code>label=</code> (opcional) Propietat de l'etiqueta. Per defecte és {{P|31}}.
* <code>valuetext=</code> (opcional) Propietat del text de l'enllaç del valor. Per defecte és un enllaç intern (vegeu formatting=internallink més amunt).
* <code>upto=</code> (opcional) Fins on volem profunditzar en l'arbre de consultes, abans no trobi cap més propietat. Tipus de valors:
** upto=''etiqueta'': última etiqueta a consultar, per exemple "upto=estat".
** upto=''valor numèric'': nombre de nivells màxim a extreure. Per defecte és 10 com a protecció, normalment un valor més alt del que serà necessari.
* <code>uptolinkid=</code> (opcional) Alternatiu a <code>upto=''etiqueta''</code> amb un Qid. Admet valors múltiples separats per un blanc o una barra inclinada.
* <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.
* <code>include_self=true</code> (opcional) Inclou l'etiqueta de la pròpia pàgina en la llista de sortida.
* <code>sorting=</code> (opcional) Ordenació 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=Qxx només mostrarà el valor corresponent a Qxx.
* <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. Per exemple, "municipi del Brasil" es presenta com a "Municipi". A [[Mòdul:Wikidata/labels]] es poden definir les correccions necessàries.
== Funció linkWithParentLabel ==
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".
== Funció yearsOld ==
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)''
== Exemples ==
Els exemples a continuació són mostres provades en les pàgines corresponents. Es poden fer proves a [[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.
| |||