Template:Immagine multipla

Documentazione

Questa documentazione è transclusa da Template:Immagine multipla/doc. (modifica | cronologia)

Illustrazioni de La Stella Polare ed il suo viaggio avventuroso
di Emilio Salgari.

Marinai che segano il ghiaccio attorno alla Stella Polare

Calafataggio della Stella Polare

Allenamento dei cani sotto le slitte.

Questo template serve a inserire una serie di immagini in sequenza, allineandole verticalmente o orizzontalmente, con una singola didascalia per tutte le immagini o una per ciascuna immagine.

Scegliendo opportunamente i parametri il template può correggere automaticamente la dimensione delle immagini a una data larghezza, dando ad ogni immagine la stessa altezza.

L'implementazione effettiva del template è effettuata dal modulo Lua Modulo:Immagine multipla

Sintassi e parametri

Breve

• allinea = allineamento della galleria rispetto alla pagina; valori: left - center - right. Se non precisata allinea a destra
• direzione = direzione delle immagini all'interno della galleria. Usare verticale per allinearle verticalmente, in caso contrario (o se non precisata) saranno allineate orizzontalmente
• larghezza = larghezza delle immagini; inserire solo il valore numerico in pixel, senza il suffisso px. Se viene specificata una larghezza specifica per un'immagine questa ha la precedenza.
• allinea didascalia = l'allineamento del testo delle didascalie delle immagini(left - center - right)
• titolo = titolo della galleria di immagini
• immagine1 = nome della prima immagine, senza il prefisso File: o Immagine:
• didascalia1 = didascalia della prima immagine
• larghezza1 = larghezza della prima immagine; inserire solo il valore numerico in pixel, senza il suffisso px. Ha la precedenza rispetto a larghezza
• sotto = didascalia globale piazzata a piè di pagina della galleria
• per riga = permette di disporre le immagini in più righe indicando quante immagini inserire per ogni riga.

Per aggiungere altre immagini, occorre aggiungere i valori immagine2, didascalia2, larghezza2 e così via per ciascuna immagine, l'esempio riporta i parametri per le prime tre immagini, ma altre possono essere aggiunte a piacere.

(legenda colori)

{{Immagine multipla
|allinea = <!-- right (default), left, center -->
|direzione = <!-- orizzontale (default), verticale -->
|sfondo = 
|larghezza = <!-- dimensione per tutte le immagini -->
|titolo = 
|immagine1 = 
|didascalia1 = 
|larghezza1 = 
|immagine2 = 
|didascalia2 = 
|larghezza2 = 
|immagine3 = 
|didascalia3 = 
|larghezza3 = 
|sotto = 
}}

Ridimensionamento immagini alla stessa altezza

Per la spiegazione parametri rimanenti vedi sopra.

• larghezza totale = larghezza totale di tutte le immagini in pixel; inserire solo il valore numerico in pixel, senza il suffisso px. Le immagini saranno ridimensionate per avere tutte la stessa altezza.
• largezza1 = quando viene specificato larghezza totale questo parametro deve indicare la larghezza reale in pixel dell'immagine. La larghezza effettiva alla quale sarà visualizzata sarà calcolata dal template in modo da poter dare a tutte le immagini la stessa altezza e una larghezza complessiva pari a larghezza totale
• altezza1 = altezza della prima immagine in pixel, precisare l'altezza delle immagini successive con altezza2, altezza3, ... altezza = n

(legenda colori)

{{Immagine multipla
|allinea = <!-- right (default), left, center -->
|direzione = <!-- orizzontale (default), verticale -->
|sfondo = 
|larghezza totale = <!-- larghezza totale delle immagini -->
|titolo = 
|immagine1 = 
|didascalia1 = 
|larghezza1 = 
|altezza1 = 
|immagine2 = 
|didascalia2 = 
|larghezza2 = 
|altezza2 = 
|immagine3 = 
|didascalia3 = 
|larghezza3 = 
|altezza3 = 
|sotto = 
}}

Parametri opzionali

• sfondo = lo sfondo della galleria che contiene le immagini, trasparente se non precisato. Vedi Aiuto:Colori per i nomi e codici utilizzabili.
• sfondo titolo = lo sfondo del titolo della galleria, trasparente se non precisato. . Vedi Aiuto:Colori per i nomi e codici utilizzabili.
• allinea titolo = allineamento del titolo della galleria (left - center - right). Se non precisato allineato al centro.
• allinea sotto = allineamento della didascalia a piè di pagina della galleria (left - center - right). Se non precisato allineato a sinistra.
• sfondo sotto = lo sfondo della didascalia a piè di pagina della galleria, trasparente se non precisato. . Vedi Aiuto:Colori per i nomi e codici utilizzabili.
• alt1 = testo alt della prima immagine
• collegamento1 = collegamento di una voce. Se inserito cliccando sull'immagine si viene rinviati alla voce collegata anziché che alla pagina dell'immagine.

Esempi

Immagini allineate in orizzontale

IL comportamento standard del template

I giocatori sono avvisati con un cartellino giallo ed espulsi con uno rosso.

{{Immagine multipla
 | larghezza = 60
 | immagine1 = Yellow card.svg
 | alt1 = Cartellino giallo
 | immagine2 = Red card.svg
 | alt2 = Cartellino rosso
 | sotto = I giocatori sono avvisati con un cartellino giallo ed espulsi con uno rosso.
 }}

Immagini allineate in verticale

Dimostrazione della trasparenza di immagini in formato PNG

Un'immagne in formato PNG con uno layer di trasparenza a 8 bit ...

...qui sovrapposto a uno sfondo a scacchi.

{{Immagine multipla
 | allinea = left
 | direzione = verticale
 | larghezza = 200
 | titolo = '''Dimostrazione della trasparenza di immagini in formato [[w:Portable Network Graphics|PNG]]'''
 | immagine1 = PNG transparency demonstration 1.png
 | alt1 = Dadi colorati su sfondo bianco
 | didascalia1 = Un'immagne in formato PNG con uno layer di trasparenza a 8 bit ...
 | immagine2 = PNG transparency demonstration 2.png
 | alt2 = Dadi colorati su sfondo a scacchi
 | didascalia2 = ...qui sovrapposto a uno sfondo a scacchi.
}}

Con uno sfondo

Adoxa moschatellina

{{Immagine multipla
 | allinea = left
 | sfondo = #BBDD99
 | larghezza = 160
 | immagine1 = Adoxa_moschatellina_210406.jpg
 | immagine2 = Adoxa_moschatellina_210406a.jpg
 | immagine3 = adoxa_moschatellina_blatt.jpeg
 | allinea sfondo = center
 | sotto = ''Adoxa moschatellina''
}}

Con collegamenti (collegamento[n])

Copertina de La Stella Polare

Nettuno

San Gennaro

L'immagine della copertina della Stella Polare è collegata alla pagina La Stella Polare ed il suo viaggio avventuroso; l'immagine di Nettuno e quella di San Gennaro sono collegate alla pagina standard di descrizione dei file.

{{Immagine multipla
 | immagine1 = Salgari - La Stella Polare (page 1 crop).jpg
 | larghezza1 = 143
 | collegamento1 = La Stella Polare ed il suo viaggio avventuroso
 | didascalia1 = Copertina de ''La Stella Polare'' 
 
 | immagine2 = Odi di Pindaro (Romagnoli) I-0243.png
 | larghezza2 = 139
 | collegamento2 = 
 | didascalia2  = Nettuno
 
 | immagine3 = Saint Januarius.jpg
 | larghezza3 = 148
 | didascalia3  = San Gennaro
 | sotto = L'immagine della copertina della ''Stella Polare'' è collegata alla pagina [[La Stella Polare ed il suo viaggio avventuroso]]; l'immagine di Nettuno e quella di San Gennaro sono collegate alla pagina standard di descrizione dei file.
}}

Incolonnare le immagini

Il comportamento standard del template è di allineare orizzontalmente le immagini, per disporle verticalmente (cioè una sopra l'altra usate il parametro direzione = verticale. Vedi esempio a fianco il risultato:

Disposte orizzontalmente

Disposte verticalmente

Dare la stessa altezza alle immagini

Illustrazioni da Le Tragedie di Sofocle

Aiace

Satiro

Pira

Fregio

Se le immagini da visualizzare hanno lo stesso rapporto d'aspetto basta regolare il parametro larghezza per dare a tutte le immagini le stesse dimensione, ma se le immagini hanno un diverso rapporto d'aspetto e si imposta la stessa larghezza per tutte il risultato è antiestetico, come nell'esempio a destra:

Per ottenere una serie di immagini con la stessa altezza quando queste hanno un diverso rapporto d'aspetto si deve procedere basta indicare la larghezza totale che deve avere la galleria d'immagini (per esempio 400 pixel) e inserirla nel parametro larghezza totale (nell'esempio quindi larghezza totale = 400).

Il template interroga automaticamente i metadati delle immagini per ottenere il rapporto d'aspetto di ognuna e calcola quale larghezza effettiva assegnare ad ogni immagine perché abbiano la stessa altezza e la larghezza della galleria di immagini sia quella desiderata.

Illustrazioni da Le Tragedie di Sofocle

Aiace

Satiro

Pira

Fregio

{{Immagine multipla
|titolo = Illustrazioni da ''[[Tragedie di Sofocle (Romagnoli) I|Le Tragedie]]'' di [[Autore:Sofocle|Sofocle]]
|larghezza totale = 400
|immagine1 = Tragedie di Sofocle (Romagnoli) I-0028.png
|didascalia1 = Aiace
|immagine2 = Tragedie di Sofocle (Romagnoli) III-0242.png
|didascalia2 = Satiro
|immagine3 = Tragedie di Sofocle (Romagnoli) I-0096.png
|didascalia3 = Pira
|immagine4 = Tragedie di Sofocle (Romagnoli) III-0157.png
|didascalia4 = Fregio
}}

Si possono comunque compilare manualmente le dimensioni delle singole immagini, in questo caso si deve esaminare la pagina di descrizione di ogni immagine per ottenere la sua risoluzione a piena immagine. Per esempio:

• File:Tragedie di Sofocle (Romagnoli) I-0028.png indica: "(1 745 × 2 067 pixel, dimensione del file: 71 KB, tipo MIME: image/png)"
• File:Tragedie di Sofocle (Romagnoli) III-0242.png indica "(1 581 × 1 646 pixel, dimensione del file: 35 KB, tipo MIME: image/png)"

Quindi si specifica per ogni immagine l'altezza e larghezza usando i parametri altezza1, altezza2, ... altezzan e larghezza1, larghezza2, ... larghezzan

Righe multiple

Per visualizzare le immagini su righe multiple usare il parametro per riga. Il valore passato può essere un numero singolo o una lista di numeri delimitati da ,. Questo caratteristica può essere combinata con il parametro larghezza totale per visualizzare righe multiple di immagini con la stessa lunghezza totale per ogni riga.

Equipaggiamento per la sorveglianza. In senso orario dall'alto: teodolite ottico, stazione robotica, livella ottica, Stazione GPS per la navigazione satellitare Cinematica in tempo reale.

{{Immagine multipla
| per riga = 2
| larghezza totale=300
| immagine1 = Kern_Theodolit_DKM2-A.jpg  |larghezza1=319|altezza1=425
| immagine2 = Total-Robotic-Station.jpg  |larghezza2=1728|altezza2=3072
| immagine3 = DumpyLevel.jpg  |larghezza3=1600|altezza3=1200
| immagine4 = GPS_Survey_Equipment_at_Weir_Dyke_Bridge_-_geograph.org.uk_-_336908.jpg|larghezza4=427|altezza4=640
| sotto = Equipaggiamento per la sorveglianza. In senso orario dall'alto: teodolite ottico, stazione robotica, livella ottica, Stazione GPS per la navigazione satellitare [[w:Cinematica in tempo reale|]].
}}

Dati per VisualEditor
La tabella TemplateData che segue è contenuta nella sottopagina Template:Immagine multipla/TemplateData (modifica·cronologia)

Questo template viene usato per inserire una serie di immagini in sequenza, allineandole verticalmente o orizzontalmente.

Parametri template[Modifica dati del modello]

Questo template ha una formattazione personalizzata.

Parametro		Descrizione	Tipo	Stato
Titolo	titolo	titolo assegnato alla galleria di immagini	Sconosciuto	facoltativo
Allinea	allinea	allineamento della galleria rispetto alla pagina; valori: left - center - right	Sconosciuto	facoltativo
Direzione	direzione	direzione delle immagini all'interno della galleria: horizontal per allinearle orizzontalmente, vertical per allinearle verticalmente	Sconosciuto	facoltativo
Larghezza	larghezza	larghezza delle immagini; inserire solo il valore numerico in pixel, senza px. Il parametro è obbligatorio	Sconosciuto	facoltativo
Sfondo	sfondo	colore dello sfondo della galleria; inserire il codice esadecimale anteponendo il simbolo #	Sconosciuto	facoltativo
Immagine1	immagine1	link all'immagine, senza il prefisso File: o Immagine:	Sconosciuto	facoltativo
Didascalia1	didascalia1	Didascalia dell'immagine	Sconosciuto	facoltativo
Immagine2	immagine2	nessuna descrizione	Sconosciuto	facoltativo
Didascalia2	didascalia2	nessuna descrizione	Sconosciuto	facoltativo
Immagine3	immagine3	nessuna descrizione	Sconosciuto	facoltativo
Didascalia3	didascalia3	nessuna descrizione	Sconosciuto	facoltativo
Immagine4	immagine4	nessuna descrizione	Sconosciuto	facoltativo
Didascalia4	didascalia4	nessuna descrizione	Sconosciuto	facoltativo
Immagine5	immagine5	nessuna descrizione	Sconosciuto	facoltativo
Didascalia5	didascalia5	nessuna descrizione	Sconosciuto	facoltativo
Immagine6	immagine6	nessuna descrizione	Sconosciuto	facoltativo
Didascalia6	didascalia6	nessuna descrizione	Sconosciuto	facoltativo
Immagine7	immagine7	nessuna descrizione	Sconosciuto	facoltativo
Didascalia7	didascalia7	nessuna descrizione	Sconosciuto	facoltativo
Immagine8	immagine8	nessuna descrizione	Sconosciuto	facoltativo
Didascalia8	didascalia8	nessuna descrizione	Sconosciuto	facoltativo
Didascalia9	didascalia9	nessuna descrizione	Sconosciuto	facoltativo
Immagine9	immagine9	nessuna descrizione	Sconosciuto	facoltativo
Immagine10	immagine10	nessuna descrizione	Sconosciuto	facoltativo
Didascalia10	didascalia10	nessuna descrizione	Sconosciuto	facoltativo