Template:Collegamenti esterni
Le 'struziune ca avènene mò stonne jndr'à sottepàgene Template:Collegamenti esterni/man (cange · cunde)
Sandbox: Template:Collegamenti esterni/Sandbox (cange · cunde) · Tutte le sottepàgene: lista
Questo template serve per inserire diversi collegamenti esterni all'inizio della sezione Collegamenti esterni in fondo alla voce, ottenendoli automaticamente dall'elemento Wikidata collegato alla pagina.
È una versione più avanzata dei precedenti template raccoglitori (es. Collegamenti cinema), dei quali riproduce tutte le funzionalità aggiungendone di nuove.
A differenza dei precedenti, è completamente scritto in Lua e non dipende da nessun altro template, a parte Modulo:Citazione per la formattazione dei collegamenti. Questo può essere un problema se l'impostazione del collegamento è diversa rispetto all'uso di un template singolo; bisogna cercare di mantenere coerenti il Collegamenti esterni e i template singoli (vedi Categoria:Template sostituiti dal template Collegamenti esterni).
Funzionalità
I collegamenti da visualizzare sono configurabili tramite il modulo:Collegamenti esterni e aggiungere un nuovo collegamento significa aggiungere poche righe a una pagina di configurazione.
Il template permette di:
- gestire i casi in cui la proprietà Wikidata abbia più valori, generando un link per ciascuno di essi (separati per le proprietà di tipo URL generico, es. siti ufficiali; sulla stessa riga per le proprietà di tipo ID);
- gestire i casi in cui la proprietà Wikidata abbia uno o più dei seguenti qualificatori: autore (P50) o stringa del nome dell'autore (P2093), titolo (P1476) o soggetto indicato come (P1810) o oggetto indicato come (P1932) o pseudonimo (P742), data di pubblicazione (P577), volume di un'opera (P478), pagina/e (P304); solo per le proprietà di tipo URL generico (es. siti ufficiali) URL di archivio (P1065), data di archiviazione (P2960), data di fine (P582);
- gestire i casi in cui le parentesi siano parte del titolo e non della disambiguazione, non rimuovendole in questo caso;
- gestire i casi in cui più proprietà abbiano lo stesso dominio dell'URL, aggiungendo un suffisso al sito per disambiguarli (su righe diverse);
- limitare l'utilizzo di una proprietà agli elementi con specifici valori di una certa altra proprietà, per evitare l'eccessiva comparsa di collegamenti poco pertinenti per i soggetti di alcune voci;
- usare, se necessario, template diversi da Cita web, ad esempio Cita video;
- inibire manualmente la creazione di uno o più collegamenti o gruppi tematici, o viceversa richiedere la creazione solo di specifici collegamenti o gruppi tematici, per evitare un numero eccessivo di collegamenti non migliorativi (si ricorda che Wikipedia non è un indice di siti web);
- generare un'iconcina di modifica in fondo a ciascun collegamento, per facilitare le correzioni del dato su Wikidata;
- categorizzare automaticamente le voci nelle sottocategorie di Categoria:Proprietà lette da Wikidata e in altre categorie di monitoraggio (vedi #Pagine correlate);
- specificare un elemento Wikidata arbitrario, utile per sperimentarne l'uso da una pagina diversa, come ad esempio una sandbox.
Sintassi
Normalmente il template non richiede alcun argomento:
* {{Collegamenti esterni}}
Nota: anteporre sempre l'asterisco, per uniformarlo alle altre righe della sezione Collegamenti esterni.
Parametri opzionali
I seguenti parametri permettono di specificare una serie di collegamenti o gruppi di essi, separati da virgole, che devono essere gli unici aggiunti all'elenco, anche se su Wikidata ne fossero disponibili altri.
prop = P11, P22, ...
: uno o più singoli collegamenti, specificando il nome della proprietà Wikidata ("P..."; passa con il mouse sull'icona di modifica in fondo al link per rivelarlo)gruppo = biografie, cinema ...
(alternativo al precedente): uno o più gruppi tematici, specificandone il nome (vedi #Proprietà Wikidata supportate)medium = libro, video ...
: tutte le opere con uno o più tipi di template di citazione (vedi "medium" in #Parametri di configurazione)
Il parametro escludi
permette, viceversa, di specificare collegamenti o gruppi che non devono essere aggiunti all'elenco, indipendentemente dalla presenza dei dati su Wikidata. Il parametro per l'esclusione è unico e si può compilare anche con una combinazione di più cose, es. "escludi=cinema, P1234, P5678, musica, libro".
Il parametro from
, esempio "from=Q1189", permette di specificare un elemento Wikidata diverso da quello della pagina corrente.
Proprietà Wikidata supportate
Nei seguenti elenchi sono indicate le proprietà Wikidata che il template è in grado di gestire.
Errore Lua: jndr'à Modulo:Collegamenti_esterni a 'a linèe 629: Impossibile trovare l'etichetta della proprietà P4547 del gruppo Sport.
Aggiunta nuove proprietà
Nella pagina di discussione del template, se necessario, si potrà proporre l'aggiunta di una nuova proprietà.
Per aggiungere una proprietà X a seguito dell'approvazione:
- aggiungere la proprietà nella giusta sottopagina del modulo:Collegamenti esterni
- creare la categoria di tracciamento "Categoria:PX letta da Wikidata", se non esiste già
- indicare l'esistenza della categoria di tracciamento nella proprietà di Wikidata con categoria di tracciamento dell'uso di una proprietà (P2875)
- indicare il fatto che la proprietà viene usata da questo template nella pagina di discussione della proprietà col d:Template:ExternalUse
- aggiungere la proprietà in Utente:Botcrux/Collegamenti esterni/properties.json
Parametri di configurazione
Questi i parametri che si possono specificare per ciascun sito nelle sottopagine di configurazione.
- pid = l'ID della proprietà Wikidata. Parametro sempre obbligatorio.
- url = il formato dell'URL; l'identificatore letto da Wikidata viene messo al posto di "$1". Parametro quasi sempre obbligatorio, da omettere solo per quelle proprietà che non contengono un identificatore, ma direttamente un URL completo (es. il sito ufficiale).
- titolo = il titolo del collegamento se diverso dal titolo della voce (eventuali disambiguazioni tra parentesi sono rimosse automaticamente, a meno che siano anche nell'etichetta dell'elemento Wikidata, che vorrebbe dire che le parentesi fanno veramente parte del nome). Può anche essere una frase che contiene il titolo stesso, che in questo caso viene messo al posto di "$1".
- sito = il nome del sito internet; se non specificato usa il dominio dell'url (default di t:Cita web), come l'omonimo parametro dei template di citazione.
- tipo = una specificazione fissa aggiunta tra parentesi, come l'omonimo parametro dei template di citazione.
- sitodis = la disambiguazione da usare quando due proprietà utilizzano lo stesso sito. Alternativo a "tipo", ha lo stesso aspetto, ma appare solo in presenza di più proprietà con lo stesso sito web.
- editore = editore del sito web, come l'omonimo parametro dei template di citazione.
- lingua = lingua/e del sito se diversa dall'italiano, come l'omonimo parametro dei template di citazione.
- cid = codice da usare con il template t:Cita, come l'omonimo parametro dei template di citazione.
- autore = autore dell'opera linkata, come l'omonimo parametro dei template di citazione. In alternativa l'autore viene letto dai qualificatori su Wikidata e può essere diverso per ogni pagina; il parametro va usato solo se l'autore è fisso per tutto il sito.
- data = data di pubblicazione dell'opera linkata, come l'omonimo parametro dei template di citazione. In alternativa la data viene letta dal qualificatore su Wikidata e può essere diversa per ogni pagina; il parametro va usato solo se la data è fissa per tutto il sito.
- multi = abilita la lettura di un certo qualificatore per distinguere i link quando una stessa proprietà ha valori multipli. Più qualificatori possibili, in ordine di priorità, si possono inserire nel formato 'P111,P222,P333...'. I collegamenti multipli vengono comunque mostrati anche senza "multi", in una sola riga nella forma "xxx / yyy / zzz", ma spesso risultano indistinguibili. Il qualificatore del titolo viene sempre mostrato anche senza "multi", mentre il parametro ne può specificare altri che vengono aggiunti tra parentesi dopo ogni link.
- medium = il template di citazione da usare, se diverso da Cita web. Ad esempio per usare t:Cita video inserire "video".
- opera = alternativo a sito; per opere che non nascono come siti web, ma sono copie online di pubblicazioni (in particolare vengono citate con la preposizione "in" anziché "su"), come l'omonimo parametro dei template di citazione.
- vincolo = crea il collegamento solo se l'elemento Wikidata soddisfa la condizione indicata. Il vincolo può essere o positivo o negativo. Nel primo caso sarà verificata la presenza di almeno un valore in una data proprietà. Nel secondo caso sarà verificato l'opposto, cioè l'assenza di uno o più valori in una o più proprietà. Inserire nel formato { 'P11', {'Q111','Q222'...}, 'P22', {'Q444','Q555'...}, ... } oppure { '-P11', {'Q111','Q222'...}, '-P22', {'Q444','Q555'...}, ... }. Permette di far apparire il collegamento solo nelle voci su certi tipi di soggetti, filtrando ad esempio in base a istanza di (P31) o occupazione (P106).
- template = nome (senza "Template:") dell'eventuale template specifico che serve a generare lo stesso link. Se presente in voce, si evita automaticamente la creazione di un duplicato. I redirect al template possono essere indicati di seguito separati da una virgola (es. "MusicBrainz, Musicbrainz").
Esempi
Inserito nella voce Usain Bolt genera:
- (Lènga 'nglese) Sito ufficiale, su usainbolt.com. Lingua sconosciuta: Lènga 'nglese (aiuto)
- Bólt, Usain, su Treccani.it – Enciclopedie on line, Istituto dell'Enciclopedia Italiana.
- Bolt, Usain, in Lessico del XXI secolo, Istituto dell'Enciclopedia Italiana, 2012-2013.
- (EN) Sieg Lindstrom, Usain Bolt, su Enciclopedia Britannica, Encyclopædia Britannica, Inc.
- (DE, EN, IT) Usain Bolt, su Transfermarkt, Transfermarkt GmbH & Co. KG.
- U. BOLT, su it.soccerway.com, Perform Group.
- (EN) Usain BOLT, su worldathletics.org, World Athletics.
- (EN) Usain Bolt, su diamondleague.com, Diamond League.
- (EN) Usain Bolt, su trackfield.brinkster.net.
- (EN, FR) Usain BOLT, su olympics.com, Comitato Olimpico Internazionale.
- (EN) Usain Bolt, su Olympedia.
- (EN) Usain Bolt, su sports-reference.com, Sports Reference LLC (archivijate da l'url origgenale il 1º novemmre 2017).
- (EN) Usain Bolt, su thecgf.com, Commonwealth Games Federation.
- (EN) Usain Bolt, su IMDb, IMDb.com.
Esempi di proprietà con valori multipli nella voce Caribou (musicista):
- Sito ufficiale, su caribou.fm.
- Caribou, su Last.fm, CBS Interactive.
- (EN) Caribou / Dan Snaith / Manitoba / Daphni, su AllMusic, All Media Network.
- (EN) Caribou, su Bandcamp.
- (EN) Dan Snaith / Caribou / Daphni / Manitoba, su Discogs, Zink Media.
- (EN) Dan Snaith / Daphni (alias of Dan Snaith aka Caribou) / Caribou (Canadian composer and musician), su MusicBrainz, MetaBrainz Foundation.
- (EN) Caribou., su SoundCloud.
- (EN) Caribou, su IMDb, IMDb.com.
Esempio di disambiguazione di proprietà diverse sullo stesso sito nella voce Cesare Maldini:
- Maldini, Cesare, su Treccani.it – Enciclopedie on line, Istituto dell'Enciclopedia Italiana.
- Alberto Costa, MALDINI, Cesare, in Enciclopedia dello Sport, Istituto dell'Enciclopedia Italiana, 2002-2005.
- Cesare Maldini, su UEFA.com, UEFA.
- (EN) Cesare Maldini, su national-football-teams.com, National Football Teams.
- (DE, EN, IT) Cesare Maldini (calciatore), su Transfermarkt, Transfermarkt GmbH & Co. KG.
- (DE, EN, IT) Cesare Maldini (allenatore), su Transfermarkt, Transfermarkt GmbH & Co. KG.
- Cesare Maldini, su smr.worldfootball.net, HEIM:SPIEL Medien GmbH.
- (FR) Cesare Maldini, su lequipe.fr, L'Équipe 24/24.
- (EN, RU) Cesare Maldini, su eu-football.info.
- (EN) Cesare Maldini, su Olympedia.
Esempio di uso del parametro "gruppo" per selezionare solo i collegamenti strettamente relativi al calcio, nella voce Lionel Messi:
- Lionel Messi, su UEFA.com, UEFA.
- (EN) Lionel Messi, su national-football-teams.com, National Football Teams.
- (DE, EN, IT) Lionel Messi, su Transfermarkt, Transfermarkt GmbH & Co. KG.
- Lionel Messi, su it.soccerway.com, Perform Group.
- Lionel Messi, su smr.worldfootball.net, HEIM:SPIEL Medien GmbH.
- (EN) Lionel Messi, su soccerbase.com, Racing Post.
- (FR) Lionel Messi, su lequipe.fr, L'Équipe 24/24.
- (DE) Lionel Messi, su fussballdaten.de, Fussballdaten Verlags GmbH.
- (EN, ES, CA) Lionel Messi, su BDFutbol.com.
- (RU) Lionel Messi, su FootballFacts, FootballFacts.ru.
Pagine correlate
- Categoria:Voci con template Collegamenti esterni senza dati da Wikidata
- Categoria:Proprietà multiple lette da Wikidata senza qualificatore
- Categoria:Voci con template Collegamenti esterni e qualificatori sconosciuti
- Categoria:Voci con template Collegamenti esterni e molti collegamenti
- Template:Avviso collegamenti esterni
Dati per VisualEditor
La tabella TemplateData che segue è contenuta nella sottopagina Template:Collegamenti esterni/TemplateData (cange·cunde)
Questo template serve per inserire diversi collegamenti esterni all'inizio della sezione Collegamenti esterni in fondo alla voce, ottenendoli automaticamente dall'elemento Wikidata collegato alla pagina. I collegamenti da visualizzare sono configurabili tramite il modulo:Collegamenti esterni e aggiungere un nuovo collegamento significa aggiungere solo quattro o cinque righe a una pagina di configurazione, senza dover creare nessun nuovo template.
Parametre | Descrizione | Tipe | State | |||
---|---|---|---|---|---|---|
Nisciune parametre specificate |