Mòdul:Wikidata/ús

De Viquidites
Salta a la navegació Salta a la cerca

Aquesta és la pàgina de documentació per a Mòdul:Wikidata

Aquest mòdul extrau dades formatades de Wikidata.

Funció bàsica:

  • claim: 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.
    • formatStatements (obsoleta): igual que claim però referit a una declaració. Es manté per compatibilitat durant la transició a claim.
    • formatQualifiers(obsoleta): igual que claim però referit a un qualificador. Es manté per compatibilitat durant la transició a claim.

Altres funcions:

  • getTAValue: 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.
  • ViewSomething: retorna qualsevol cosa de les dades estructurades, incloent etiquetes, descripcions, referències i enllaços interwiki.
Sintaxi completa
{{#invoke:Wikidata|claim|property= |qualifier= |value= |list= |tablesort= |formatting= |separator= |conjunction= |item= |showerrors= |default= }}
sintaxi addicional pel format de taula:
{{#invoke:Wikidata|claim|property= |qualifier= |qualifier2= |...|qualifier9= |tablesort= |rowformat= |rowsubformat1= |...|rowsubformat9= |formatting=table |separator= |conjunction= |item= |showerrors= |default= }}
Paràmetres
  • property= (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 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 estat (P17).
  • qualifier= (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.
    • qualifierProperty= (obsolet): àlies de qualifier. Es manté per compatibilitat, a substituir.
  • value= (opcional) Valor preferent al de Wikidata. Pot ser un paràmetre opcional en una plantilla amb el format {{{paràmetre|}}}, així si existeix pren el valor del paràmetre i sinó el valor de Wikidata.
  • list= (opcional) amb valors true o false. Per defecte assumeix list=true traient una llista dels valors de totes les declaracions o els qualificadors (vegeu separator i conjuction). Si list=false traurà només un valor, el primer amb rang preferent o el primer de tots si tenen rang normal.
    • tablesort=0 (opcional) ordenació ascendent de la llista. Per defecte l'ordenació és pel rang (preferent, normal, obsolet) i per l'antiguitat de definició a Wikidata.
    • rank= (obsolet) Es manté per compatibilitat, a substituir. Amb qualsevol valor equival a list=false. Anteriorment tenia els valors rank=preferred (el preferent) o rank=one (el primer) unificats al preferent per defecte. El cas especial rank=ca equival a formatting=ca.
  • formatting= (opcional) Format desitjat. El format per defecte és un enllaç conduït. Valors possibles:
    • Format d'element (entity):
      • formatting=raw Número identificador de l'element.
      • formatting=label Etiqueta de l'element.
      • formatting=sitelink Títol de la pàgina de la Viquipèdia de l'element.
      • formatting=internallink 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.
      • formatting=pattern Format segons un patró usant $1 com a paràmetre a substituir.
    • Format de text (string):
      • formatting=weblink Format d'enllaç extern [http://example.com example.com]
      • formatting=pattern Format segons un patró usant $1 com a paràmetre a substituir.
    • Format numèric (quantity):
      • formatting=unit Format numèric incloent la unitat.
      • formatting=unitcode Format numèric incloent el codi o l'abreviatura de la unitat definit a Mòdul:Wikidata/Units.
    • Format multilingüe (monolingualtext):
      • formatting=language 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 nom oficial (P1448).
      • formatting=text És una versió específica per a propietats amb format monolingual text que recupera exclusivament el text, ja que quan es recupera sense formatting s'obtindrà un text que inclou la marca de llengua <span lang="en">United...</span>.
      • formatting=ca o qualsevol valor diferent de language i text. Sols treu un valor, el de la versió catalana d'una llista multivalor de "monolingual text". Exemple: forma femenina de l'etiqueta (P2521).
    • Format coordenades (globecoordinate):
      • formatting=latitude Valor de latitud en una declaració de coordenades, en format decimal
      • formatting=longitude Valor de longitud en una declaració de coordenades, en format decimal
      • formatting=dimension Valor de dimensió en una declaració de coordenades, en metres, equivalent al paràmetre dim de GeoHack.
    • Format de dates (time):
      • formatting= format #time Accepta qualsevol format vàlid de la funció d'analitzador #time. Per exemple: formatting=d-m-Y (04-10-2019), formatting=[[j xg]] (4 d'octubre). Per defecte usa el format "j F Y" (4 octubre 2019)
      • formatting=year (obsolet) equival a formatting=Y (2019)
    • Format de taula de propietat i qualificadors:
      • formatting=table Taula de valors de llista de propietats amb els seus qualificadors. Es poden indicar fins a 9 qualificadors i el format de cada línia. Els separadors són per defecte salts de línia (vegeu separator i conjunction). Paràmetres específics per a aquest format:
        • qualifier2 ... qualifier9= Qualificadors addicionals al primer qualifier.
        • rowformat= Format de la fila de propietat més qualificadors. La propietat s'indica amb $0 i els qualificadors $1 a $9. Per defecte és rowformat=$0 ($1, ... $9). Pot incloure marques de llistes * o #.
        • rowsubformat1 ... rowsubformat9= Subformat opcional a aplicar a $1-$9 definits en rowformat. Pot ser útil per no trencar el format en cas d'un qualificar buit. Per exemple, "rowformat=$0 $1" i "rowsubformat1=per $1" resulta "$0 per $1" o bé "$0" sense qualificador.
        • tablesort= amb valors de 0 a 9, permet ordenar la taula per la propietat (0) o els qualificadors (1 a 9). Per defecte l'ordenació és pel rang de la propietat (preferent, normal, obsolet) i per l'antiguitat de definició a Wikidata.
  • case= (no usat) Cas gramatical a generar. De moment no hi ha funcions definides.
  • separator= (opcional) Separador a usar en llistes, per defecte una coma i un espai en blanc ', '. Per a llistes en vertical es pot usar per exemple <br />, o <li> per llistes puntejades.
  • conjunction= (opcional) Conjunció a usar com a separador entre els dos últims elements de la llista, per defecte ' i '.
  • item= (opcional) Permet indicar un item (Qnnnnn) diferent a l'article actiu. Cal fer-lo servir amb moderació pel seu alt consum de recursos.
  • showerrors= (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.
  • default= (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.
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 item per un element de Wikidata diferent de la pàgina actual.

  • Ús simple:
{{#invoke:Wikidata | claim |property=P20}} a l'article Jean-François Champollion dóna: París
és la propietat lloc de defunció (P20), per defecte amb el valor enllaçat.
  • Sense enllaç:
{{#invoke:Wikidata | claim | property=P20 | formatting=label}} dóna: París
  • Valor preferent:
{{#invoke:Wikidata | claim | property=P20 | value={{{lloc_mort|}}} }} en la infotaula de l'article donarà
el valor de {{{lloc_mort|}}} si està definit en l'article, en cas contrari París
  • Valor tipus data:
{{#invoke:Wikidata | claim | property=P569}} dóna la data de naixement amb el format per defecte:
23 desembre 1790 i 22 desembre 1790
  • Formatat amb un patró:
{{#invoke:Wikidata | claim | property=P214 | formatting=[http://viaf.org/viaf/$1 $1]}} dóna:
34454460
  • Un únic valor:
Imatge de mostra
{{#invoke:Wikidata | claim | property=P18 | list=false | formatting=[[File:$1|thumb|upright=.5|Imatge de mostra]]}}
Treu només la primera de les imatges definides.
  • Format d'enllaç extern:
{{#invoke:Wikidata | claim | property=P856 | formatting=weblink}} a Berlín dóna:
www.berlin.de/
  • Llista de valors:
{{#invoke:Wikidata | claim | property=P47}} a Alcoià dóna:
l'Alacantí, l'Alt Vinalopó, Comtat, Marina Baixa, Vall d'Albaida i Vinalopó Mitjà
Cal notar l'enllaç conduït [[Comtat (País Valencià)|Comtat]]
  • Llista formatada:
{{#invoke:Wikidata | claim | property=P150 | separator=<br /> | conjunction=<br />}} dóna
Alcoi
Banyeres de Mariola
Benifallim
Castalla
Ibi
Onil
Penàguila
Tibi
  • Coordenades:
{{#invoke:Wikidata | claim | property=P625 | formatting=latitude}} dóna: 38.701944444444
{{#invoke:Wikidata | claim | property=P625 | formatting=longitude}} dóna: -0.47722222222222

Vegeu també[modifica el codi]