Template:Wikidata/man
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).[1]
Parametri posizionali
[modifica]Il template ha due parametri posizionali:
{{Wikidata|Pxxx|{{{parametro|}}}}}
- il codice della proprietà su Wikidata (obbligatorio): esempio:
{{Wikidata|P19}}
utilizzato nella voce Dante Alighieri ritornerà: Firenze (P19 è il luogo di nascita) - il secondo parametro posizionale è facoltativo: se valorizzato, il template ritorna 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|}}}}}
ritornerà: 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
[modifica]Parametri di selezione
[modifica]- 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.
- rank: è valorizzato in modo predefinito al valore 'best'. Se valorizzato con un certo rank, il template ritorna 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 ritornati le dichiarazioni a partire dal rank più alto: i preferred se presenti altrimenti i normal.
- qualifier: codice di un qualificatore di una proprietà. Verranno ritornati solo le dichiarazioni che posseggono quel qualificatore.
- qualifiervalue: valore del qualificatore specificato con il parametro qualifier. Verranno ritornati solo le dichiarazioni che posseggono quel qualificatore e con il valore specificato con qualifiervalue.
- qualifiertype: ulteriore filtro sul qualificatore specificato. Ha attualmente un unico valore accettato,
qualifiertype=latest
: se il qualificatore contiene un valore di tipo "time", verrà ritornato solo la dichiarazione che possiede quel qualificatore e con il valore più recente. - n: se la proprietà ha più dichiarazioni ritorna 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 ritornata sempre quella.
Parametri per la formattazione del risultato
[modifica]- 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=/}}
ritornerà: poeta/scrittore/prosatore/politico/filosofo/teorico politico/intellettuale/linguista
- esempio:
- pattern: pattern utilizzato per ogni dichiarazione, sia per le proprietà che per il parametro "value" quando presente. La stringa "$1" verrà rimpiazzata dal valore ritornato 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]]}}
ritornerà:[[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 ritornerebbe[[File:Test.png|thumb|Il nome del file è Test.png]]
, altrimenti se Immagine non fosse valorizzato, lo stesso risultato dell'esempio precedente.
- esempio:
- list: formatta il risultato ritornato come lista non ordinata, si deve assegnargli un valore qualunque, es: "list=sì". Eventuali parametri separator e conjunction vengono ignorati.
- esempio:
{{Wikidata|P106|from=Q1067|list=1}}
- esempio:
- orderedlist: formatta il risultato ritornato come lista ordinata, 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 creata una lista non ordinata
- esempio:
{{Wikidata|P106|from=Q1067|orderedlist=1}}
- esempio:
- 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)
- esempio:
- 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.
- 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.[2]
- 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
- esempio: normalmente con
- 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").
- esempio:
- langit: se impostato a "no" (langit=no) non restituisce i valori con lingua "it" (italiano).
- 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, tramite il quale viene effettuata l'operazione di conversione.
- esempio:
{{Wikidata|P2048|unit=chilometro|from=Q243}}
→ 0.33 (Q243 è Torre Eiffel e P2048 è "altezza")
- esempio:
- showunit: se impostato a qualunque valore, esempio "showunit=sì", verrà restituto anche il simbolo dell'unità di misura dopo il valore.[3]
- esempio:
{{Wikidata|P2048|showunit=sì|from=Q243}}
→ 330
- esempio:
- 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
- esempio:
- 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
- esempio:
Pagine correlate
[modifica]Note
[modifica]- ↑ La funzionalità è presente in it.wiki dal 1° giugno 2015.
- ↑ Come per il parametro "from", l'utilizzo di showprop rende la chiamata al template una expensive parser function, quindi non utilizzabile più di 500 volte in una stessa pagina.
- ↑ Se showunit è utilizzato senza il parametro unit (quindi senza ulteriore conversione) il simbolo è ottenuto direttamente da Wikidata (dalla proprietà simbolo unità (P558)). Se invece è usato in unione a unit, il simbolo dell'unità di misura, come il valore convertito, è ottenuto dal modulo:Conversione, e quindi limitato alle unità configurate nel modulo Conversione.
[[Immagine:{{{immagine}}}|center|150px]]
Le discussioni possono essere avviate nella pagina di discussione del Dipartimento e se raggiungono dimensione eccessiva possono essere scorporate in sottopagine. In questa sezione viene mantenuto un elenco delle discussioni più importanti e recenti. |
|
| |
|