Template:Wikidata/man

Il template {{Wikidata}} serve per leggere il valore di una proprietà di Wikidata, relativa alla pagina corrente, cioè la pagina in cui è utilizzato il template. Sarà in futuro possibile leggere le proprietà anche di pagine diverse da quella corrente. Il template fornisce un utilizzo più avanzato, a volte senza alternativa, rispetto a quello che si può ottenere con la magic word: {{#property:NumProprietà}}.

Gli esempi utilizzati fanno riferimento all'articolo Firenze (le cui proprietà su Wikidata sono queste: d:Q2044).

Parametri posizionali

Il template ha due parametri posizionali:

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

1. il codice della proprietà su Wikidata (obbligatorio): esempio: {{Wikidata|P17}} ritornerà: Italia (P17 è lo Stato)
2. 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|P17|{{{Stato|}}}}} ritornerà: il valore di Stato se valorizzato, altrimenti quello della proprietà P17 su Wikidata

Nel caso una proprietà ha più di un valore (statement) li può restituire tutti, separandoli con una virgola e inserendo la congiunzione "e" prima dell'ultimo, oppure filtrarli se si specifica un rank, un qualifier 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. [[Salvador (Brasile)|Salvador]]). Il nome italiano dell'articolo 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

• rank: è valorizzato in modo predefinito al valore 'best'. Se valorizzato con un certo rank, il template ritorna solo gli statement 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 gli statement a partire dal rank più alto: i preferred se presenti altrimenti i normal.
• qualifier: codice di un qualifier di una proprietà. Verranno ritornati solo gli statement che posseggono quel qualifier.
• qualifiervalue: valore del qualifier specificato con il parametro qualifier. Verranno ritornati solo gli statement che posseggono quel qualifier e con il valore specificato con qualifiervalue.
• qualifiertype: ulteriore filtro sul qualifier specificato. Ha attualmente un unico valore accettato, qualifiertype=latest: se il qualifier contiene un valore di tipo "time", verrà ritornato solo lo statement che possiede quel qualifier e con il valore più recente.
• n: se la proprietà ha più statement ritorna l'n-esimo
  • esempio: {{Wikidata|P190|n=1}} ritornerà: Reims (P190 è la città gemellata), mentre con n=2 avrebbe ritornato Kassel, con n=3 Edimburgo, ecc.
• entityId: per ora NON FUNZIONANTE, quando sarà attivato permetterà di specificare un'entity di Wikidata relativa a una pagina diversa da quella in cui ci si trova

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|P190|separator=/|conjunction=/}} ritornerà: Reims/Kassel/Edimburgo/... ecc...
• pattern: pattern utilizzato per ogni statement, sia per le proprietà che per il parametro "value" quando presente. La stringa "$1" verrà rimpiazzata dal valore ritornato per ogni sua occorrenza.
  • esempio: {{Wikidata|P94|pattern=[[File:$1|thumb|Il nome del file è $1]]}} ritornerà: [[File:FlorenceCoA.svg|thumb|Il nome del file è FlorenceCoA.svg]] (d:P94 è lo stemma)
  • esempio con value: {{Wikidata|P94|{{{Immagine|}}}|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.
• 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|P190|list=1}}
• 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|P190|orderedlist=1}}
• formatting: esegue formattazioni speciali, attulmente i valori consentiti sono: formatting=latitude e formatting=longitude per ritornare solo latitudine o longitudine in caso di proprietà di tipo coordinata

Pagine correlate

• Template:WikidataQ - per leggere il valore di un qualifier di una proprietà di Wikidata
• Template:WikidataN - per ottenere il numero di statement di una proprietà
• Modulo:Wikidata - modulo che implementa le funzionalità dei template Wikidata, WikidataQ e WikidataN