Template:Immagine multipla/doc

Da Wikisource.
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[modifica]

Breve[modifica]

  • 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[modifica]

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[modifica]

  • 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[modifica]

Immagini allineate in orizzontale[modifica]

IL comportamento standard del template

Cartellino giallo
Cartellino rosso
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[modifica]

Dimostrazione della trasparenza di immagini in formato PNG
Dadi colorati su sfondo bianco
Un'immagne in formato PNG con uno layer di trasparenza a 8 bit ...
Dadi colorati su sfondo a scacchi
...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[modifica]

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])[modifica]

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[modifica]

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[modifica]

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:

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

Righe multiple[modifica]

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|]].
}}