Template:Wikidata/man

Questa è la pagina di documentazione per Template:Wikidata

Il template {{Wikidata}} serve per leggere il valore di una proprietà di Wikidata. Il template fornisce un utilizzo più avanzato, a volte senza alternativa, rispetto a quello che si può ottenere con la funzione: {{#property:proprietà}}.

Di default il template legge le proprietà relative all'elemento Wikidata collegato alla pagina in cui è utilizzato il template. Specificando il parametro from è possibile leggere le proprietà di qualunque altro elemento, così come avviene con #property (si veda accesso arbitrario).

Parametri posizionali

Il template ha due parametri posizionali:

{{Wikidata|Pxxx|{{{parametro|}}}}}

1. il codice della proprietà su Wikidata (obbligatorio): esempio: {{Wikidata|P19}} usato nella voce Dante Alighieri restituirà: Firenze (P19 è il luogo di nascita)
2. il secondo parametro posizionale è facoltativo: se valorizzato, il template restituisce il valore di questo parametro invece di quello su Wikidata, formattandolo eventualmente secondo il pattern se specificato. Serve quando si usa il template all'interno di un altro template, per dare la precedenza al valore passato al template rispetto a quello su Wikidata. Esempio: {{Wikidata|P19|{{{LuogoNascita|}}}}} restituirà: il valore di LuogoNascita se valorizzato, altrimenti quello della proprietà P19 su Wikidata

Nel caso una proprietà abbia più di un valore (detto statement, dichiarazione) il template li può restituire tutti, separandoli con una virgola e inserendo la congiunzione "e" prima dell'ultimo, oppure filtrarli se si specifica un rank, un qualificatore o un indice. È possibile formattare l'output attraverso delle opzioni. Se la pagina non ha un elemento su Wikidata, oppure non ha la proprietà specificata, oppure il valore della proprietà è a sua volta un elemento che non ha un'etichetta in italiano, non restituisce nulla. Se possibile, i valori delle proprietà sono restituiti con wikilink, compresa eventuale disambiguazione nascosta con la barra verticale (es. [[Savoia (dipartimento)|Savoia]]). Il nome italiano della voce viene ricavato dall'interlink del rispettivo elemento su Wikidata; se il soggetto non è presente su Wikidata, il valore viene restituito senza wikilink.

Parametri con nome

Parametri di selezione

• from: permette di specificare un elemento Wikidata arbitrario, potendo così leggere le proprietà anche di elementi diversi da quello collegato alla pagina in cui si è utilizzato il template. Così come per #property, l'accesso agli elementi tramite il parametro "from" rende la funzione una "expensive parser function" (si veda mw:Manual:$wgExpensiveParserFunctionLimit). Queste ultime non possono essere usate più di 500 volte in una stessa pagina.
  • esempio: {{Wikidata|P36|from=Q38}} restituirà: Roma (P36 è la capitale e Q38 è l'Italia).
• rank: è valorizzato in modo predefinito al valore 'best'. Se valorizzato con un certo rank, il template restituisce solo le dichiarazioni che hanno quel valore. I rank disponibili sono i tre definiti da Wikidata: deprecated, normal e preferred, più il tipo best. Con quest'ultimo vengono restituiti le dichiarazioni a partire dal rank più alto: i preferred se presenti altrimenti i normal.
• snaktype: se valorizzato a "value" (default), "novalue", "somevalue" o "all" verranno restituite rispettivamente solo le dichiarazioni con valore noto, "nessun valore", "valore sconosciuto" (si veda d:Help:Statements#Unknown or no values), o tutte. Il default è "value", quindi normalmente vengono ignorate le dichiarazioni di tipo novalue e somevalue, che altrimenti apparirebbero come "nessun valore" e "valore sconosciuto".
• qualifier: codice di un qualificatore di una proprietà. Verranno restituite solo le dichiarazioni che posseggono quel qualificatore. Se viene utilizzato anche il parametro qualifiervalue il qualificatore dovrà anche avere il valore specificato.
• noqualifier: codice di un qualificatore di una proprietà. Al contrario del precedente parametro qualifier, verranno restituite solo le dichiarazioni che non posseggono quel qualificatore.
• qualifieroptnovalue: codice di un qualificatore di una proprietà. Verranno restituite solo le dichiarazioni che non posseggono quel qualificatore, oppure se lo posseggono quelle con valore diverso da quello specificato nel parametro qualifiervalue.
• qualifiervalue: valore del qualificatore, da usare in accoppiata con i parametri qualifier o qualifieroptnovalue.
• qualifiertype: ulteriore filtro sul qualificatore specificato. Ha attualmente un unico valore accettato, qualifiertype=latest: se il qualificatore contiene un valore di tipo "time", verrà restituito solo la dichiarazione che possiede quel qualificatore e con il valore più recente.
• n: se la proprietà ha più dichiarazioni restituisce l'n-esimo. Nota: la selezione è applicata per ultima, dopo i filtri per rank e qualificatore, quindi se per esempio una proprietà ha dieci dichiarazioni di cui una con rank preferred, con n=1 continuerà a essere restituita sempre quella.
  • esempio: {{Wikidata|P106|from=Q1067|n=1}} restituirà: poeta (P106 è l'occupazione e Q1067 è Dante Alighieri, con cinque dichiarazioni con rank normale per P106), mentre con n=2 avrebbe restituito scrittore, con n=3 prosatore (senza wikilink perché Q4964182 non è collegato a una voce in it.wiki).
• wd: se impostato a "no" il template restituisce unicamente il valore impostato nel secondo parametro posizionale, se presente, altrimenti una stringa vuota, disabilitando quindi la lettura da Wikidata.

Parametri per la formattazione del risultato

• separator: separatore tra valori multipli, se diverso da virgola_spazio
• conjunction: separatore tra gli ultimi due valori, se diverso da spazio_e_spazio
  • esempio: {{Wikidata|P106|from=Q1067|separator=/|conjunction=/}} restituirà: poeta/scrittore/prosatore/politico/filosofo/teorico politico/intellettuale/linguista
• pattern: pattern utilizzato per ogni dichiarazione, sia per le proprietà che per il parametro "value" quando presente. La stringa "$1" verrà rimpiazzata dal valore restituito per ogni sua occorrenza. È possibile inserire wikitesto, ma eventuali caratteri "{" e "}" potrebbero dover essere preceduti da "\", e il carattere "|" sostituito con {{!}}.
  • esempio: {{Wikidata|P18|from=Q1067|pattern=[[File:$1|thumb|Il nome del file è $1]]}} restituirà: [[File:Portrait de Dante.jpg|thumb|Il nome del file è Portrait de Dante.jpg]] (P18 è l'immagine)
  • esempio con value: {{Wikidata|P18|{{{Immagine|}}}|from=Q1067|pattern=[[File:$1|thumb|Il nome del file è $1]]}} In un template, se il parametro Immagine fosse valorizzato a "Test.png" allora restituirerebbe [[File:Test.png|thumb|Il nome del file è Test.png]], altrimenti se Immagine non fosse valorizzato, lo stesso risultato dell'esempio precedente.
• list: formatta il risultato restituito come elenco puntato, si deve assegnargli un valore qualunque, es: "list=sì". Eventuali parametri separator e conjunction vengono ignorati.
  • esempio: {{Wikidata|P106|from=Q1067|list=1}}
• orderedlist: formatta il risultato restituito come elenco numerato, si deve assegnargli un valore qualunque, es: "orderedlist=sì". Eventuali parametri separator e conjunction vengono ignorati. Se sono presenti entrambi i parametri list e orderedlist viene creato un elenco puntato
  • esempio: {{Wikidata|P106|from=Q1067|orderedlist=1}}
• formatting: se impostato a raw, esempio "formatting=raw", restituisce l'identificativo numerico nel caso di proprietà di tipo elemento (esempio "Q123456") e il timestamp nel caso di proprietà di tipo time (esempio "+00000002013-01-01T00:00:00Z")
• showqualifiers: aggiunge al risultato uno o più qualificatori, tra parentesi.
  • esempio: {{Wikidata|P38|showqualifiers=P580|from=Q38}} → euro (1º gennaio 2002)
  • con due qualificatori: {{Wikidata|P38|showqualifiers=P580,P582|rank=normal|from=Q38}} → lira italiana (2 giugno 1946, 28 febbraio 2002)

Per il solo tipo stringa

• urlencode: se impostato a qualunque valore, esempio "urlencode=sì", codifica la stringa per l'utilizzo in un URL, nella query string

Per il solo tipo coordinate geografiche

• coord: se impostato a latitude o longitude, esempio "coord=latitude" o "coord=longitude", restituisce rispettivamente solo la latitudine o la longitudine. Con "coord=globe" restituisce l'URL dell'elemento Wikidata a cui si riferiscono le coordinate, per la Terra http://www.wikidata.org/entity/Q2.

Per il solo tipo url

• extlink: se impostato a qualunque valore, esempio "extlink=sì", e la proprietà o il valore inserito localmente sono un URL valido, lo restituisce come link esterno senza il protocollo. Per esempio se l'URL vale http://www.sitoesterno.it → si otterrà [http://www.sitoesterno.it www.sitoesterno.it]. È utile nei sinottici per leggere l'URL da Wikidata e ottenere al contempo la rimozione del protocollo, altrimenti eseguita solitamente voce per voce. Esempio in un template basato su {{Infobox}}:

|Valore1 = {{Wikidata|P856|{{{sito|}}}|extlink=sì}}

Nel caso invece si voglia una etichetta prestabilita per il link, allora non è necessario il parametro extlink ma è sufficiente pattern, esempio:

|Valore1 = {{Wikidata|P856|{{{sito|}}}|pattern=[$1 Sito ufficiale]}}

Per il solo tipo elemento

• showprop: nel caso di proprietà di tipo elemento, restituisce la proprietà specificata invece dell'elemento.
  • esempio: normalmente con {{Wikidata|P17|from=Q10285}} si otterrebbe → Italia (Q10285 è Colosseo e P17 è "nazione"). Aggiungendo showprop=P298 (P298 è il codice ISO 3166-1 alpha-3) si otterrà invece {{Wikidata|P17|showprop=P298|from=Q10285}} → ITA

Per il solo tipo testo monolingua

• showlang: se impostato a qualunque valore, esempio "showlang=sì", antepone a ciascun valore l'indicazione della lingua (utilizza il Modulo:Linguaggi).
  • esempio: {{Wikidata|P1705|showlang=sì|from=Q1757}} → (FI) Helsinki e (SV) Helsingfors (Q1757 è Helsinki e P1705 è "nome originale locale").
• includelang: permette di definire i soli linguaggi da visualizzare, che vanno inseriti come uno o più codici separati dalla virgola, esempio includelang=it,fr
• excludelang: permette di definire i linguaggi da non visualizzare, che vanno inseriti come uno o più codici separati dalla virgola, esempio excludelang=en,es

Per il solo tipo quantità

• unit: effettua la conversione all'unità di misura specificata. Sono supportate tutte le unità di misura configurate nel modulo:Conversione (qui la configurazione, vedere da "config.alias" in poi), tramite il quale viene effettuata l'operazione di conversione.
  • esempio: {{Wikidata|P2048|unit=chilometro|from=Q243}} → 0.33 (Q243 è Torre Eiffel e P2048 è "altezza")
• showunit: se impostato a qualunque valore, esempio "showunit=sì", verrà restituto anche il simbolo dell'unità di misura dopo il valore.
  • esempio: {{Wikidata|P2048|showunit=sì|from=Q243}} → 330 m
• showunitlink: quando è utilizzato showunit, se impostato a qualunque valore, esempio "showunitlink=sì", crea il wikilink del simbolo dell'unità.
  • esempio: {{Wikidata|P2048|unit=cm|showunit=sì|showunitlink=sì|from=Q243}} → 33000 cm
• formatnum: se impostato a qualunque valore, esempio "formatnum=sì", formatta il risultato come con la funzione parser formatnum.
  • esempio: {{Wikidata|P2048|formatnum=sì|unit=chilometro|from=Q243}} → 0,33
• formatduration: se impostato a qualunque valore, esempio "formatduration=sì", e su Wikidata l'unità di misura è di tempo fra quelle supportate dal modulo:Conversione (secondo, minuto e ora), restituisce il risultato espresso in giorni, ore, minuti e secondi.
  • esempio: {{Wikidata|P2147|formatduration=sì|from=Q111}} → 1 giorno, 37 minuti e 22 secondi
• rounding: arrotonda il risultato al numero di decimali richiesto:
  • esempio: {{Wikidata|P2370|formatnum=sì|rounding=3|from=Q3710}} → 0,305 (senza rounding=3 avrebbe restituito 0,3048)

Per il solo tipo data e ora

• time: a seconda del valore a cui è impostato (es. "time=precision") permette di ottenere rispettivamente:
  • "calendarmodel": l'URL dell'elemento Wikidata del modello di calendario a cui si riferisce la data/ora
  • "precision": il livello di precisione: 0 - miliardi di anni, 1 - centinaia di milioni di anni, 2 - decine di milioni di anni, 3 - milioni di anni, 4 - centinaia di millenni, 5 - decine di millenni, 6 - millennio, 7 - secolo, 8 - decade, 9 - anno, 10 - mese, 11 - giorno (la precisione 12 - ora, 13 - minuto, 14 - secondo non è ancora supportata, si veda phab:T57755).
  • "year": la data con precisione anno (la precisione su Wikidata deve essere maggiore o uguale a 9)
  • "month": la data con precisione mese (la precisione su Wikidata deve essere maggiore o uguale a 10)
  • "day": la data con precisione giorno (la precisione su Wikidata deve essere maggiore o uguale a 11)