Aiuto:Markup immagini

Da Wikipedia, l'enciclopedia libera.
(Reindirizzamento da Wikipedia:Markup immagini)
Abbreviazioni
WP:MI

Questa pagina di aiuto spiega il linguaggio di markup delle immagini, cioè l'insieme di "marcatori" (regole o convenzioni, espressioni codificate) per aggiungere immagini, illustrazioni e grafici alle pagine di Wikipedia.

Inserimento di un'immagine[modifica | modifica wikitesto]

Nuvola apps khelpcenter.pngSportello informazioni

Dopo aver caricato (o trovato) un'immagine su Wikimedia Commons o su it.wiki (l'edizione in lingua italiana di Wikipedia), per inserirla in una pagina basta scriverne il nome preceduto e seguito dalle doppie parentesi quadre, come un collegamento interno (wikilink). In pratica, di solito si scrive:

[[File:Esempio.png | miniatura | didascalia ]]

Dove Esempio.png è il nome dell'immagine (es. Torre di Pisa 2008.jpg), miniatura o thumb è un parametro per la formattazione predefinita dell'immagine (vedi anche più sotto), e didascalia è il breve testo che descrive il suo contenuto (es. "La Torre di Pisa").

Quella appena descritta è la sintassi tipica, cioè quella da usare nel 90% dei casi, e provvede automaticamente a creare una miniatura dell'immagine di dimensioni ottimali, allineata a destra. Di solito non serve altro. In casi particolari può tuttavia essere utile modificare alcuni parametri (allineamento, dimensione ecc.), come descritto di seguito.

Suggerimenti[modifica | modifica wikitesto]

  • Inserire sempre una linea vuota dopo l'immagine per evitare disallineamenti del testo con il browser Internet Explorer.
  • Non c'è alcuna differenza tra le immagini che si trovano su Commons e quelle che sono su it.wiki; in tutti gli esempi di questa pagina in cui è usato il prefisso File: davanti al nome del file, si può usare anche Immagine: o Image: in modo del tutto indifferente, dovunque sia ospitata l'immagine.
[[Immagine:Esempio.png]] oppure [[Image:Esempio.png]] o, più correttamente, [[File:Esempio.png]]
  • Si tenga presente che, quando sia Commons sia it.wiki contengono un'immagine con lo stesso nome, la precedenza andrà all'immagine di it.wiki, che sarà quindi quella mostrata nella pagina (se l'immagine è la stessa si prega di segnalarla con {{nowcommons}} o se diversa chiedere di rinominarla inserendo nella pagina dell'immagine la riga {{spostare|nuovo_nome_file|omonimia con immagine diversa su Commons}}).

Posizione rispetto al testo[modifica | modifica wikitesto]

Per cambiare la posizione dell'immagine rispetto al testo della pagina si possono indicare dei parametri opzionali dopo il nome del file, separandoli con una barra verticale, |.

Senza scorrimento del testo:

Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. [[File:Esempio.png|none]]

Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.

Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
Esempio.png

Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.

Allineata a sinistra, con scorrimento:

Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. [[File:Esempio.png|left]]

Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.

Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
Esempio.png

Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.

Centrata nella pagina:

Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. [[File:Esempio.png|center]]

Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.

Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
Esempio.png

Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.

Allineata a destra, con scorrimento:

Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. [[File:Esempio.png|right]]

Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.

Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
Esempio.png

Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.

Nota: Per terminare lo scorrimento del testo a lato dell'immagine, andando a capo e ritornando alla massima larghezza della pagina, è necessario inserire i seguenti tag:

  • A capo su entrambi i margini: {{clear|both}}.
  • A capo sul margine sinistro: {{clear|left}}.
  • A capo sul margine destro: {{clear|right}}.

Se non si specifica una posizione, le immagini con cornice (parametri thumb o frame, vedi sotto) vengono di default allineate a destra.

Le immagini senza cornice invece si comportano di default come se fossero parole di testo; si allineano a sinistra, ma se inserite all'interno di una frase come questa Flag of Italy.svg, diventano parte della frase stessa. In questi casi è possibile specificare anche un ulteriore parametro che indica l'allineamento verticale rispetto alle parole: "baseline", "middle" (default), "sub", "super", "text-top", "text-bottom", "top", o "bottom". Esempio di top Flag of Italy.svg e di bottom Flag of Italy.svg. E' comunque un sistema usato molto raramente e solo con immagini molto piccole.

Didascalie, bordi e testo alternativo[modifica | modifica wikitesto]

È raccomandato aggiungere all'immagine una didascalia, un bordo o un testo alternativo, che viene automaticamente visualizzato al posto di quest'ultima dai browser testuali. Il testo alternativo rappresenta un elemento importante per l'accessibilità delle pagine, in particolare agli utenti disabili e non vedenti.

Testo alternativo[modifica | modifica wikitesto]

Exquisite-kfind.png Per approfondire, vedi Aiuto:Testo alternativo per le immagini.

In genere è utile (anzi è caldamente consigliato) corredare l'immagine con un breve testo descrittivo, che costituirà la legenda dell'immagine laddove non potesse essere vista dal lettore. Questo funge anche da testo alternativo (in HTML ALT TEXT).

La didascalia va inserita dopo il nome dell'immagine e dopo gli eventuali parametri opzionali, separandola con una barra verticale, |. Il testo alternativo dev'essere l'ultima informazione prima delle parentesi quadre di chiusura.

Testo alternativo

Immagine con testo alternativo:
[[File:Esempio.png|Testo alternativo]]

Bordo (o cornice)[modifica | modifica wikitesto]

Gnome-globe.svg

Per ottenere un piccolo bordo (o cornice), è necessario specificare il parametro opzionale border che fa sì che l'immagine venga visualizzata con un piccolo bordo grigio intorno a essa.

Immagine con bordo (o cornice):
[[File:Esempio.png|border]]

Didascalia[modifica | modifica wikitesto]

Didascalia

Per ottenere una didascalia è necessario specificare il parametro opzionale thumb oppure frame che fa sì che l'immagine venga visualizzata sulla destra, racchiusa in una cornice e con la didascalia in basso; la didascalia, che va separata dalle opzioni con una seconda barra verticale, |, sostituisce il testo alternativo dell'immagine. Per indicare anche un testo alternativo bisogna usare il parametro alt.

Immagine incorniciata con didascalia:
[[File:Esempio.png|thumb|Didascalia]]

Immagine incorniciata con didascalia e testo alternativo:
[[File:Esempio.png|thumb|alt=Un globo terrestre|Didascalia]]

Link interni e siti esterni

Didascalia con collegamenti:
Il testo della didascalia può contenere dei collegamenti ad altre voci di Wikipedia (wikilink) oppure a siti esterni.

[[File:Esempio.png|thumb|[[Aiuto:Wikilink|Link]] interni e [http://en.wikipedia.org siti] esterni]]

Se il testo della didascalia è costituito da una sola frase o da un semplice nome non inserire un punto finale; se, viceversa, il testo che accompagna e descrive l'immagine è composito e composto da più frasi, osservare la normale punteggiatura adottata abitualmente per i testi.

Attenzione! Assicurarsi sempre che il numero di parentesi quadre aperte e chiuse sia corretto: una parentesi in più o in meno significa il mancato funzionamento dell'intero comando [[File: ]].

Dimensioni dell'immagine[modifica | modifica wikitesto]

Nell'inserire immagini e tabelle, tieni conto sia della resa grafica (pensa ai tanti utenti che usano basse risoluzioni video), sia del peso complessivo della pagina (molti utenti hanno infatti sistemi non recentissimi e possono usare connessioni lente).
Prova a vedere come appare la pagina anche a bassa risoluzione (ad esempio 800x600 o 1024x768) e non eccedere col peso delle immagini; non impostare le dimensioni delle immagini di tipo thumb se non è strettamente necessario, lascia che abbiano la larghezza di default scelta dall'utente. Verifica poi che la pagina non debba essere scorsa orizzontalmente o che parti di essa si sovrappongano. Inoltre assicurati che il contenuto sia sempre accessibile anche in assenza di immagini.
Globo di lettere

Miniature[modifica | modifica wikitesto]

Se non viene specificata, la dimensione con cui viene presentata l'immagine è quella con cui è stata caricata; per garantire a tutti una migliore accessibilità è preferibile utilizzare le miniature (opzione thumb o miniatura), affinché la dimensione visualizzata sia opportunamente ridimensionata e incorniciata. È possibile personalizzare tale dimensione dalle proprie preferenze utente. Ogni utente è libero di cambiare le proprie preferenze in base alle necessità (es. velocità di connessione veloce e dimensione dello schermo).

Il Lago di Bolsena al tramonto

Esempio:

[[File:Lago bolsena tramonto.jpg|thumb|Il Lago di Bolsena al tramonto]]

Il parametro thumb imposta le immagini a una larghezza massima di default di 220 pixel (fino al 10 giugno 2010 è stata 180 pixel), indipendentemente dal loro sviluppo in altezza. Le immagini che in originale sono più strette di 220 pixel non vengono ingrandite ma mostrate nella dimensione reale.

Se non sono specificati altri parametri, la miniatura apparirà allineata a destra, con la didascalia sotto (se fornita) e con un simbolo di zoom (ingrandisci) che indica la possibilità di vedere l'immagine nelle sue dimensioni reali.

Esiste anche l'opzione frameless, alternativa a thumb, che ha tutte le caratteristiche di ridimensionamento automatico delle miniature, ma è sprovvista della cornice. In quanto immagine senza cornice è allineata come le parole e la didascalia diviene testo alternativo.

Dimensionamento relativo[modifica | modifica wikitesto]

Immagine con upright

Talvolta può essere necessario ridimensionare manualmente l'immagine, perché ha orientamento o contenuti particolari. È generalmente preferibile farlo in maniera proporzionale alla dimensione standard di ciascun utente. Le immagini con opzione thumb si possono ridimensionare in maniera relativa alla larghezza di default, con il parametro upright o verticale.

Il parametro è nato inizialmente per le immagini con orientamento verticale, e se utilizzato senza ulteriori specificazioni applica una larghezza un po' più stretta di quella delle normali miniature, circa il 75% (170 pixel nel caso dell'impostazione di default di 220 pixel).

Esempio (l'ordine di inserimento dei parametri non è importante), con risultato a fianco:

[[File:Salmonlarvakils.jpg|thumb|upright|Immagine con ''upright'']]

Al parametro può essere inoltre assegnato un valore numerico (upright=N), per applicare un ridimensionamento qualsiasi. Il valore da inserire è il rapporto tra la larghezza desiderata e quella di default delle miniature, utilizzando il punto come separatore decimale. Ad esempio il parametro upright=2 crea un'immagine di larghezza doppia, mentre upright=0.5 crea un'immagine larga la metà. Non ha ovviamente senso inserire upright=1 (è come non metterlo), mentre upright=0.75 equivale a upright senza numero.

Immagine con upright=0.5

Esempio:

[[File:Lago bolsena tramonto.jpg|thumb|upright=0.5|Immagine con ''upright=0.5'']]

Notare che upright, qualunque sia il valore, non sgranerà mai l'immagine facendola apparire più grande della dimensione reale. Come con il solo thumb, le immagini che in originale sono più strette di quanto richiesto vengono mostrate nella dimensione reale.

Dimensionamento assoluto[modifica | modifica wikitesto]

È possibile impostare in assoluto la dimensione in pixel dell'immagine, sebbene sia una pratica da evitare, perché vanifica le impostazioni dell'utente e può danneggiare l'accessibilità. Se necessario, per forzare una certa larghezza si deve indicare il numero di pixel seguito, senza spazi, dai caratteri minuscoli px, ad esempio 250px; l'altezza verrà calcolata automaticamente.

Il Lago di Bolsena in secca

Esempio:

[[File:Lago bolsena tramonto.jpg|100px|thumb|Il Lago di Bolsena in secca]]

Se la larghezza in pixel viene fornita assieme al parametro thumb, come per tutte le miniature rappresenterà una larghezza massima, mentre se non è una miniatura è possibile forzare anche una larghezza maggiore dell'originale, "stirando" l'immagine.

Dimensionamento dell'altezza[modifica | modifica wikitesto]

Time 100 George Lucas.jpg

È possibile anche definire l'altezza dell'immagine usando il formato "AAAxBBBpx", che permette di mostrare l'immagine con una dimensione massima di AAA pixel di larghezza o BBB di altezza, sempre mantenendo le proporzioni. In tale caso l'immagine non viene distorta, ma la miniatura, una volta raggiunto il massimo in una delle due misure, ridimensionerà l'altra in proporzione.

Ad esempio usando la sintassi

[[File:Time 100 George Lucas.jpg|4000x100px|right]]

si ottiene l'immagine a destra, con un'altezza di 100 px.

E' possibile anche forzare soltanto l'altezza, inserendo ad esempio x100px.

Dimensioni reali[modifica | modifica wikitesto]

Tramonto sul lago di Bolsena (dimensioni originali)

L'opzione frame permette di inserire un'immagine nelle sue dimensioni originali e incorniciata. Il frame è compatibile con le didascalie e l'allineamento. Ogni tipo di ridimensionamento manuale verrà ignorato.

[[File:Lago bolsena tramonto.jpg|frame|right|Tramonto sul lago di Bolsena]]

Immagini grandi[modifica | modifica wikitesto]

L'uso di immagini grandi, tramite l'opzione frame o l'impostazione di valori molto elevati di upright o di px, dovrebbe essere limitato a casi di effettiva necessità (diagrammi particolareggiati, panoramiche orizzontali...). Teniamo presente che le immagini non devono essere di intralcio nella lettura della voce; per chi desidera vedere in dettaglio un'immagine, è sufficiente cliccarla. In particolare è bene evitare immagini di questo tipo nella sezione iniziale.

Con immagini molto larghe può essere preferibile l'uso dell'allineamento center, per evitare che a lato dell'immagine ci sia del testo, che alle basse risoluzioni verrebbe schiacciato in una colonna troppo stretta.
È inoltre possibile inserire immagini che possono scorrere orizzontalmente, senza mai fuoriuscire dallo schermo, utilizzando il template {{Immagine grande}}. Può essere usato ad esempio con i panorami a 360 gradi. Ad esempio, il comando {{immagine grande|Skyline-New-York-City.jpg|2000px}} produce l'immagine

Skyline-New-York-City.jpg

Ritaglio di un'immagine[modifica | modifica wikitesto]

Exquisite-kfind.png Per approfondire, vedi Template:Ritaglio immagine con CSS.

Per visualizzare in una voce solo il dettaglio di un'immagine, è consigliabile modificare l'immagine per creare una immagine derivata, caricando l'immagine ottenuta con un nuovo nome e con la stessa licenza dell'immagine originale. Nei casi in cui non fosse possibile, può essere utilizzato il template {{Ritaglio immagine con CSS}}.

Gallerie di immagini[modifica | modifica wikitesto]

Exquisite-kfind.png Per approfondire, vedi Aiuto:Manuale di stile#Gallerie.

È possibile, in alcuni casi tassativi, impaginare più immagini sotto forma di galleria. La sintassi da usare è la seguente:

<gallery>

File:Nomefile.estensione|Didascalia
File:Nomefile.estensione|Didascalia
...
</gallery>

E il risultato che viene visualizzato è simile a questo:

Il tag gallery accetta quattro parametri (vedi il Manuale di MediaWiki):

  • caption={caption}: imposta il titolo della gallery.
  • widths={width}px: imposta la larghezza delle immagini.
  • heights={heights}px: imposta l'altezza massima delle immagini.
  • perrow={integer}: imposta il numero di immagini per ogni riga.

Ad esempio la sintassi <gallery perrow="2" > imposta due immagini per riga. Si raccomanda di utilizzare la sintassi standard; i parametri aggiuntivi possono essere utilizzati solo in casi particolari e ben motivati.

Parametri aggiuntivi[modifica | modifica wikitesto]

A partire dal MediaWiki 1.22, ci sono nuovi parametri sfruttabili per costruire gallerie di miglior utilità. Il parametro mode, ad esempio, consente di sistemare le immagini con altezza costante e didascalia a scomparsa.

Qualche esempio. Dal seguente codice (relativo al mode="traditional", che è anche il default)

<gallery mode="traditional">
File:Astronotus_ocellatus.jpg|''[[commons:Astronotus ocellatus|Astronotus ocellatus]]'' (Oscar)
File:Salmonlarvakils.jpg|''[[commons:Salmo salar|Salmo salar]]'' (Salmon Larva)
File:Georgia Aquarium - Giant Grouper.jpg|''[[commons:Epinephelus lanceolatus|Epinephelus lanceolatus]]'' (Giant grouper)
</gallery>

si ottiene:

Altri esempi:

mode="nolines"

mode="packed"

mode="packed-overlay"

mode="packed-hover"

Collegamento alla pagina di descrizione[modifica | modifica wikitesto]

Per creare un wikilink alla pagina di descrizione dell'immagine, aggiungere il carattere "due punti" (:) all'inizio del collegamento; in tal modo il software lo interpreta come un link interno. Il nome del file può essere seguito da una barra verticale, |, ed eventualmente da un testo. Se è presente solo la barra verticale, viene eliminato il prefisso 'File:' e visualizzato solo il nome del file; se presente, il testo che segue la barra verticale viene visualizzato al posto del nome dell'immagine.

Collegamento diretto all'immagine[modifica | modifica wikitesto]

Per creare un wikilink diretto all'immagine in formato scaricabile, ignorando la pagina di descrizione, utilizzare il prefisso Media: anziché File: o Immagine:; anche in questo caso il software lo interpreta come un link interno, con o senza i due punti iniziali. Il nome del file può essere seguito da una barra verticale, |, ed eventualmente da un testo. Se è presente solo la barra verticale, viene eliminato il prefisso 'Media:' e visualizzato solo il nome del file; se presente, il testo che segue la barra verticale viene visualizzato al posto del nome dell'immagine.

Il prefisso Media ha anche un comportamento diverso con la funzione ifexist.

Link[modifica | modifica wikitesto]

Normalmente cliccare su un'immagine rimanda alla pagina contenente la sua descrizione. Tuttavia usando il parametro link si può fare in modo che il clic rimandi ad un'altra pagina. Ad esempio, il codice

[[File:Flag of Italy.svg|20px|link=Italia|Italia]]

genera l'immagine Italia che rimanda alla voce Italia.

Se la pagina a cui si vuole fare puntare l'immagine è un sito esterno, bisogna specificare l'intero URL della pagina. Ad esempio,

[[File:Presidential flag of Italy.svg|20px|link=http://www.quirinale.it/|Sito ufficiale della Presidenza della Repubblica Italiana]]

genera l'immagine Sito ufficiale della Presidenza della Repubblica Italiana che rimanda al sito ufficiale della Presidenza della repubblica italiana.

Se invece si vuole rendere l'immagine "inerte", cioè fare in modo che il cliccarla non abbia alcun effetto, è sufficiente aggiungere il parametro link= senza alcun valore, cioè vuoto. Così, ad esempio:

[[File:Gnome-globe.svg|20px|link=]]

produce Gnome-globe.svg su cui, come è facile constatare, il clic non produce effetto.

È importante sottolineare che l'utilizzo di questo parametro è previsto solo in casi molto determinati e in particolare va evitato nelle comuni immagini presenti nel namespace principale.

Pagine correlate[modifica | modifica wikitesto]

Immagini Progetto Immagini: collabora a Wikipedia sull'argomento Immagini