Help: Immagini

This page is a translated version of the page Help:Images and the translation is 90% complete.

Outdated translations are marked like this.

Nota: Quando modifichi questa pagina, acconsenti a pubblicare il tuo contributo con licenza CC0. Vedi le pagine di aiuto sul dominio pubblico per maggiori informazioni.

Questa pagina descrive la sintassi per un'immagine quando si modifica il wiki. Di solito tu o un altro utente dovete caricare un'immagine prima di poterla usare in una pagina.

Le immagini memorizzate su un server MediaWiki sono solitamente mostrate utilizzando il prefisso namespace File: (ma anche il vecchio prefisso namespace Image: è ancora supportato come sinonimo) come destinazione per un collegamento MediaWiki. Il prefisso namespace alternativo Media: è anche usato come riferimento al contenuto del file multimediale originale (per renderlo visibile o scaricarlo separatamente, fuori da una pagina MediaWiki).

Requisiti

Prima di usare le immagini nella tua pagina, l'amministratore di sistema del tuo wiki deve aver attivato il caricamento dei file e un utente deve caricare il file. Gli amministratori di sistema potrebbero anche impostare il wiki in modo tale da accettare file da repository esterni, come il Wikimedia Commons. Per il ridimensionamento delle immagini lato server è necessario avere uno scaler configurato (come GD2, ImageMagick, etc.).

Tipi di file supportati per le immagini

I seguenti formati di file sono supportati in maniera predefinita:

.jpg o .jpeg - immagini bitmap compresse nel formato JPEG standard (questo formato è con qualità inferiore ed è più adatto per fotografie).
.png - immagini bitmap in formato Portable Network Graphics (specifica del W3 Consortium).
.gif - immagini bitmap nell'obsoleto formato Graphics Interchange Format.
.webp - WebP supports both lossy and lossless compression while reducing image size by up to 45%.

Altri formati utilizzati su Wikimedia, e comunemente abilitati da altre parti (questi potrebbero richiedere configurazioni ulteriori oltre a ciò che è abilitato in maniera predefinita):

.svg - immagine scalabile nel formato Scalable Vector Graphics (specifica dal W3 Consortium). Vedi Manuale:Amministrazione delle Immagini#SVG.
.tiff - Tagged Image File Format. Spesso utilizzato per le foto di archivio ad alta risoluzione. Spesso utilizzato con Extension:PagedTiffHandler .
.ogg, .oga, .ogv - file multimediali Ogg (audio o video). Non è un formato immagine, ma è trattato in maniera simile. Spesso usato con Extension:TimedMediaHandler
.pdf - documenti a più pagine nel formato Portable Document Format (inizialmente su specifiche di Adobe). Spesso usato insieme a Extension:PdfHandler
.djvu - documenti a più pagine nel formato DejaVu (molto spesso usato per scansioni di libri). Vedi Manual:How to use DjVu with MediaWiki
Per i file in formato .pdf o .djvu viene mostrata solo una singola pagina per volta volta.

Altri tipi di file potrebbero essere supportati, ma potrebbe non essere possibile mostrarli in linea.

Visualizzazione di una singola immagine

Sintassi

La sintassi completa per mostrare un'immagine è:

[[File:filename.extension|options|caption]]

dove "options" può essere vuoto o scelte tra le seguenti parole minuscole, separati dalle barre verticali (""|""):

Opzioni di formato: (vedi esempi più avanti) border, e uno di frameless, frame, (oppure framed), oppure thumb (o thumbnail). Note: border can be used in combination with frameless but will be ignored if used with one of the other options.
Controlla come l'immagine visualizzata viene formattata ed incorporata nel resto della pagina.
Opzioni di ridimensionamento: uno di
- {larghezza}px — Ridimensiona l'immagine per adattarla all'interno della larghezza massima data in pixel, senza restrizioni sulla sua altezza. (I pixel possono essere definiti solo come valori interi. È permesso un carattere di spazio tra il valore della larghezza e "px".)
- x{altezza}px — Ridimensiona l'immagine per adattarla all'interno dell'altezza massima data in pixel, senza restrizioni sulla sua larghezza. I pixel possono essere definiti solo come valori interi. È permesso un carattere di spazio tra il valore dell'altezza e "px".
- {larghezza}x{altezza}px — Ridimensiona l'immagine per adattarla all'interno della larghezza e dell'altezza massima definiti in pixel. I pixel possono essere definiti solo come valori interi. È permesso un carattere di spazio tra il valore dell'altezza e "px".
- upright — Ridimensiona un'immagine ad un mutiplo della dimensione predefinita dall'utente - o alla dimensione predefinita della miniatura per gli utenti disconnessi o gli utenti che hanno effettuato l'accesso che non hanno modificato le proprie preferenze - per adattarla a dimensioni ragionevoli. Questa opzione è spesso utile per le immagini la cui altezza è maggiore della larghezza. Richiede thumb o frameless. Impostando |upright=1.0| mostrerà l'immagine alla larghezza predefinita dell'utente. |upright=2.0| mostrerà l'immagine al doppio della larghezza predefinita dell'utente.
L'immagine manterrà sempre il suo rapporto d'aspetto.

Immagini con tipi di supporto non-scalabili possono essere ridotte di dimensione, ma non incrementate; per esempio, le immagini bitmap non possono essere ingrandite.

L'impostazione upright non richiede il simbolo di uguaglianza, ossia |upright 2.0| funziona come |upright=2.0|.

Quando viene definito senza un valore o il segno di uguale (per esempio |upright|), viene utilizzato il valore predefinito che è |upright=0.75| (mentre |upright=| equivale a |upright=1.0|).

La massima dimensione predefinita dipende dal "formato" e dalle dimensioni interne dell'immagine (a seconda del tipo di supporto).
Opzione di allineamento orizzontale: uno tra i valori left, right, center, none. Se sono presenti più opzioni, viene considerato solo il primo.
Controlla l'allineamento orizzontale (e gli stili in linea/a blocco o fluttuante) dell'immagine all'interno di un testo (senza valore predefinito).
Opzione di allineamento verticale: uno tra i valori baseline, sub, super, top, text-top, middle, bottom, text-bottom.
Controlla l'allineamento verticale di un'immagine non fluttuante in linea con il testo prima o dopo l'immagine, e nello stesso blocco (l'allineamento verticale predefinito è middle).
Opzioni di collegamento: uno di
- link={target} — Consente di cambiare la destinazione (ad un titolo di pagina arbitrario, o ad un URL) del collegamento generato, attivo sull'area (click) dell'immagine visualizzata; per esempio [[File:Example.jpg|20px|link=http://www.wikipedia.org]] diventa (un collegamento esterno), o [[File:Example.jpg|20px|link=MediaWiki]] diventa (un collegamento interno).
- link= (con un valore nullo) — (MediaWiki 1.14+) Mostra un'immagine senza alcun collegamento attivabile; per esempio [[File:Example.jpg|20px|link=]] diventa .
Se è presente un carattere di spazio vuoto tra link e il segno di uguale, l'indirizzo del collegamento verrà visualizzato come la didascalia.

Includendo alcuni caratteri HTML equivalenti, come %22 per il carattere ", fa si che la definizione del collegamento venga considerata come una didascalia (vedi phabricator:T306216).

! per MW 1.24 e precedenti: Se imposti |link=| (vuoto), allora il titolo non verrà visualizzato. (Vedi phabricator:T23454.)
Altre opzioni specifiche:
- alt={testo alternativo} — (MediaWiki 1.14+) Definisce il testo alternativo (associato all'attributo HTML alt="..." dell'elemento generato ‎<img />) di un'immagine che verrà renderizzata se l'immagine referenziata non può essere scaricata e incorporata, o se il media di supporto deve necessariamente usare il testo descrittivo alternativo (per esempio quando si usa un lettore Braille o con opzioni di accessibilità impostati dall'utente nel proprio browser).
Se è presente un carattere di spazio vuoto tra alt e il segno di uguale, l'espressione alt verrà visualizzata come una didascalia.
- page={number} — ** $1={numero} — Renderizza il numero di pagina specificato (al momento applicabile solo quando si mostra un file .djvu o .pdf).
- thumbtime={number} — Renders a thumbnail from the video at the specified timestamp in seconds or MM:SS or HH:MM:SS format (only applicable when showing a video file).
- start={number} — When video playback is started it will start at the specified timestamp in seconds or MM:SS or HH:MM:SS format (only applicable when showing a video file).
- muted — When media playback is started, audio will be muted.
- loop — Media will loop continuously. (only applies to audio and video)
- lossy={false} — (PagedTiffHandler ) For using PNG instead of JPG thumbnails for Tiff images
- class={html class} — (MediaWiki 1.20+)** ‎<span>...‎</span>={classe html} — ($2) Definisce classi (associato all'attributo HTML class="..." dell'elemento ‎<img /> generato).
  Default behavior since MediaWiki 1.40, optional since MediaWiki 1.36.^[1] Previously the class was applied directly to the ‎<img /> element.^[2]
- lang={language code} — (MediaWiki 1.22+) ** $1={codice della lingua} — ($2) Per file SVG che contengono affermazioni <switch> variando sull'attributo systemLanguage, seleziona in quale lingua si vuole renderizzare il file. È impostata in maniera predefinita la lingua della pagina (si imposta alla lingua predefinita del progetto nella maggior parte dei progetti).

Se un parametro non corrisponde a nessuna delle altre possibilità, si presume che sia il testo della didascalia. Se è presente più di una singola stringa non-parametrica, quella finale verrà usata come didascalia. La didascalia viene mostrata sotto l'immagine nei formati thumb e frame, o come testo tooltip in qualunque altro formato. Le didascalie mostrate nei formati thumb e frame potrebbero contenere link wiki e altre formattazioni. Le estensioni di MediaWiki possono aggiungere opzioni aggiuntive.

Se 'alt' non è specificato e viene fornita una didascalia, il testo alternativo verrà creato automaticamente a partire dalla didascalia, togliendo la formattazione, tranne quando si è in modalità "thumb" o "frame" dato che la didascalia è già leggibile dai lettori dello schermo in quel caso.

Formato

La seguente tabella mostra l'effetti di tutti i formati disponibili.

Descrizione	Tu digiti	Ottieni
senza formato specificato Rendered as a floating block: no Rendered inline: yes Rendered caption: no	... text text text [[File:example.jpg\|caption]] text text text ...	... text text text text text text ...
border risulta in un bordo grigio molto sottile Rendered as a floating block: no Rendered inline: yes Rendered caption: no	... text text text [[File:example.jpg\|border\|caption]] text text text ...	... text text text text text text ...
frameless, come thumbnail, rispetta le preferenze di utente per la larghezza dell'immagine, ma senza bordo e senza flusso di testo alla sua sinistra. Rendered as a floating block: no Rendered inline: yes Rendered caption: no	... text text text [[File:example.jpg\|frameless\|caption]] text text text ...	... text text text text text text ...
frameless e border Rendered as a floating block: no Rendered inline: yes Rendered caption: no	... text text text [[File:example.jpg\|frameless\|border\|caption]] text text text ...	... text text text text text text ...
frame Rendered as a floating block: yes Rendered inline: no Rendered caption: yes	... text text text [[File:example.jpg\|frame\|caption]] text text text ...	... text text text caption text text text ...
thumb o thumbnail Rendered as a floating block: yes Rendered inline: no Rendered caption: yes	... text text text [[File:example.jpg\|thumb\|caption]] text text text ...	... text text text caption text text text ...

Quando l'altezza di un'immagine nell'anteprima è maggiore della sua larghezza (ossia è orientata verticalmente invece che orizzontalmente) e lo ritieni troppo largo, puoi provare ad usare l'opzione upright=N, dove N è il rapporto d'aspetto dell'immagine (la sua larghezza divisa per la sua altezza, predefinito a 0.75). L'alternativa è specificare l'altezza massima desiderata (in pixel) esplicitamente.

Da notare che scrivendo thumb={nome del file}, puoi usare una differente immagine per l'anteprima.

Dimensione e cornice

Tra i diversi formati, l'effetto del parametro di dimensione può essere differente, come si può osservare di seguito.

Per come potrebbe apparire quando la dimensione non è specificata, vedere la sezione Formato sopra.
Quando il formato non è specificato, o è solo incorniciato con border, la dimensione può essere sia ridotta che allargata a qualunque dimensione indicata.

Negli esempi di seguito, la dimensione originale dell'immagine è 400 × 267 pixel.

Un'immagine con frame ignora sempre l'indicazione della dimensione; l'immagine originale sarà ridotta se eccede la dimensione massima definita nelle preferenze dell'utente, e la pagina informativa mostrerà un errore Linter.
La dimensione di un'immagine con thumb o frameless può essere ridotta, ma non può essere aumentata oltre la dimensione originale dell'immagine.

Formato	Ridotto	Allargato
(not specified)	[[File:example.jpg\|50px]]	[[File:example.jpg\|500px]]
border	[[File:example.jpg\|border\|50px]]	[[File:example.jpg\|border\|500px]]
frame	[[File:example.jpg\|frame\|50px]]	[[File:example.jpg\|frame\|500px]]
thumb	[[File:example.jpg\|thumb\|50px]]	[[File:example.jpg\|thumb\|500px]]
frameless	[[File:example.jpg\|frameless\|50px]]	[[File:example.jpg\|frameless\|500px]]

Allineamento orizzontale

Da notare che quando si usano i formati frame o thumb[nail], l'allineamento orizzontale predefinito è right per le lingue scritte da sinistra verso destra, e left per quelle scritte da destra verso sinistra.

Descrizione	Tu digiti	Ottieni
senza specificare l'allineamento orizzontale, o allineamento predefinito Rendered as a floating block: no Rendered inline: yes	... text text text [[File:example.jpg\|100px\|caption]] text text text ...	... text text text text text text ...
specifica l'allineamento orizzontale come: none Rendered as a floating block: no Rendered inline: no	... text text text [[File:example.jpg\|none\|100px\|caption]] text text text ...	... text text text caption text text text ...
specifica l'allineamento orizzontale come: center Rendered as a floating block: no Rendered inline: no	... text text text [[File:example.jpg\|center\|100px\|caption]] text text text ...	... text text text caption text text text ...
specifica l'allineamento orizzontale come: left Rendered as a floating block: yes Rendered inline: no	... text text text [[File:example.jpg\|left\|100px\|caption]] text text text ...	... text text text caption text text text ...
specifica l'allineamento orizzontale come: right Rendered as a floating block: yes Rendered inline: no	... text text text [[File:example.jpg\|right\|100px\|caption]] text text text ...	... text text text caption text text text ...

Allineamento verticale

L'opzione di allineamento verticale ha effetto solo se l'immagine è renderizzata come un elemento in linea e non è fluttuante. Loro alterano il modo in cui l'immagine in linea verrà verticalmente allineata con il testo presente nello stesso blocco prima e/o dopo questa immagine sulla stessa riga renderizzata.

Da notare che la linea renderizzata di testo dove le immagini in linea vengono inserite (e le linee di testo renderizzate dopo quella corrente) potrebbe essere spostata verso il basso (questo incrementa il line-height in modo condizionale di un spaziatura di linea aggiuntiva, esattamente come potrebbe accadere con intervalli di testi con dimensioni dei caratteri variabili, o con apici e pedici) per permettere all'altezza dell'immagine di essere interamente mostrata con questo vincolo di allineamento.

Permetti/Chiudi la visualizzazione del codice sorgente

<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''top:''' [[File:Example.jpg|20px|top]] [[File:Example.jpg|40px|top]] [[File:Example.jpg|100px|top]]
<del>text</del></u></span></p>
 
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''text-top:''' [[File:Example.jpg|20px|text-top]] [[File:Example.jpg|40px|text-top]] [[File:Example.jpg|100px|text-top]]
<del>text</del></u></span></p>
 
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
<sup>super:</sup> [[File:Example.jpg|20px|super]] [[File:Example.jpg|40px|super]] [[File:Example.jpg|100px|super]]
<del>text</del></u></span></p>
 
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''baseline:''' [[File:Example.jpg|20px|baseline]] [[File:Example.jpg|40px|baseline]] [[File:Example.jpg|100px|baseline]]
<del>text</del></u></span></p>
 
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
<sub>'''sub:'''</sub> [[File:Example.jpg|20px|sub]] [[File:Example.jpg|40px|sub]] [[File:Example.jpg|100px|sub]]
<del>text</del></u></span></p>
 
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''default:''' [[File:Example.jpg|20px]][[File:Example.jpg|40px]] [[File:Example.jpg|100px]]
<del>text</del></u></span></p>
 
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''middle:''' [[File:Example.jpg|20px|middle]] [[File:Example.jpg|40px|middle]] [[File:Example.jpg|100px|middle]]
<del>text</del></u></span></p>
 
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''text-bottom:''' [[File:Example.jpg|20px|text-bottom]] [[File:Example.jpg|40px|text-bottom]] [[File:Example.jpg|100px|text-bottom]]
<del>text</del></u></span></p>
 
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''bottom:'' [[File:Example.jpg|20px|bottom]] [[File:Example.jpg|40px|bottom]] [[File:Example.jpg|100px|bottom]]
<del>text</del></u></span></p>

Per mostrare l'allineamento risultante più chiaramente, gli intervalli di testo sono sopralineati e sottolineati, la dimensione del carattere è incrementato del 200%, e il blocco del paragrafo è contornato con un bordo sottile; in aggiunta immagini di diverse dimensioni sono allineate:

~~text~~ top: ~~text~~

~~text~~ text-top: ~~text~~

~~text~~ ^super: ~~text~~

~~text~~ baseline: ~~text~~

~~text~~ _sub: ~~text~~

~~text~~ default: ~~text~~

~~text~~ middle: ~~text~~

~~text~~ text-bottom: ~~text~~

~~text~~ bottom: ~~text~~

Note:

La posizione di allineamento verticale "middle" dell'immagine (che risulta essere l'impostazione predefinita) di solito si riferisce al centro tra l'altezza "x" e la linea di base del testo (su cui il centro verticale dell'immagine sarà allineato, e su cui di solito il testo si potrebbe sovrapporre), ma non a metà dell'altezza di riga dell'altezza di carattere che si riferisce allo spazio tra la posizione di "cima del testo" e di "fondo del testo"; l'altezza del carattere esclude:
- la spaziatura di separazione della riga aggiuntiva normalmente divisa equamente in due margini di linea (qua 0.5em, secondo l'altezza di riga impostata a 200%) sopra e sotto l'altezza del carattere.
- la spaziatura di riga addizionale che potrebbe essere aggiunta da apici e pedici.
Comunque, se l'altezza dell'immagine causa la parte superiore o inferiore di andare sopra o sotto la normale altezza di riga completa del testo, la posizione centrale verrà aggiustata dopo l'incremento delle righe di margini superiori e/o inferiori in modo tale che l'immagine possa adattarsi e allinearsi appropriatamente, e tutte le immagini (incluse quelle con altezze minori) saranno verticalmente centrate nella posizione centrale aggiustata (per calcolare l'effettiva altezza di riga, verrà considerato il testo di ogni riga renderizzata con l'altezza di carattere maggiore).
Le posizioni di allineamento di "cima del testo" e di "fondo del testo" escludono anche la spaziatura di riga extra aggiunta dagli apici e i pedici, ma non la spaziatura di riga aggiuntiva definita dall'altezza di riga.
Le posizioni di allineamento superiori e inferiori tengono in considerazione della spaziatura di riga extra (inclusi apici e pedici, se sono presenti in un intervallo di riga renderizzato). Quando l'allineamento dell'immagine limita l'immagine dal superare sopra o sotto la normale spaziatura di riga, e l'immagine non è assolutamente posizionata, l'immagine renderà le posizioni "di cima" e "di fondo" aggiustate (come gli apici e i pedici), quindi l'effettiva altezza di riga tra le righe renderizzate di testo saranno più alte.
Le posizioni delle decorazioni del testo "sottolineato", "sopralineato" e "sovrapposto" dovrebbero essere tra questi due limiti e "potrebbe" dipendere dal tipo e dall'altezza dei caratteri utilizzati (gli stili di apice e pedice potrebbero essere tenuti in considerazione in alcuni browser, ma di solito questi stili sono ignorati e la posizione di queste decorazioni potrebbe non essere aggiustata); quindi queste decorazioni normalmente non influenzano la posizione verticale delle immagini, relativamente al testo.

Fermare il flusso di testo

A volte è desiderabile fermare il testo (o altri immagini in linea non fluttuanti) dallo scorrere attorno ad un'immagine fluttuante. A seconda della risoluzione di schermo del browser web e simili, il flusso di testo nella parte destra di un'immagine potrebbe far apparire un'intestazione di sezione (per esempio, == Mia intestazione ==) alla destra dell'immagine, invece che sotto di esso, come un utente potrebbe aspettarsi. Il flusso di testo può essere fermato inserendo $code1 (o se preferisci, <div style="clear: both"></div>) prima del testo che dovrebbe iniziare sotto l'immagine fluttuante. (Questo potrebbe essere effettuato anche senza una riga vuota avvolgendo la sezione con le immagini fluttuanti con <div style="overflow: hidden">…</div>, che cancella tutti i float dentro all'elemento div.)

Tutte le immagini renderizzate come blocchi (incluse immagini non fluttuanti di "center", di "left" o di "right", come le immagini fluttuanti framed o thumbnail) implicitamente rompono le linee di testo circostanti (terminando il blocco corrente di testo prima dell'immagine, e creando un nuovo paragrafo per il testo successivo a loro). Allora si impileranno verticalmente seguendo il loro margine di allineamento destro o sinistro (o lungo la linea centrale tra questi margini per immagini di "center").

Cambiare la destinazione del collegamento predefinito

La seguente tabella mostra come modificare la destinazione del collegamento (il cui valore predefinito è la pagina di descrizione dell'immagine) o come rimuoverlo. Cambiando il collegamento non si altera il formato descritto nelle sezioni precedenti.

Descrizione

Tu digiti

Ottieni

collegamento interno

... text text text
[[File:example.jpg|link=Main Page|caption]]
text text text ...

... text text text

text text text ...

collegamento esterno

... text text text
[[File:example.jpg|link=http://wikipedia.org/wiki/Test|caption]]
text text text ...

... text text text

text text text ...

senza collegamento (esterno o pagina di file)

... text text text
[[File:example.jpg|link=|caption]]
text text text ...

... text text text

text text text ...

Attenzione:

I requisiti di licenza nel tuo wiki potrebbero non permetterti di rimuovere tutti i link alla pagina di descrizione che mostra le attribuzioni richieste degli autori, le dichiarazioni di copyright, i termini di licenza applicabili, o una più completa descrizione dell'immagine renderizzata (inclusa la sua cronologia delle modifiche).

Se cambi o rimuovi la destinazione del collegamento di un'immagine, allora dovrai fornire da qualche altra parte nella tua pagina un link esplicito a questa pagina di descrizione, o mostrando il copyright e la dichiarazione dell'autore e un link alla licenza applicabile, se sono diversi dagli elementi applicabili alla pagina di incorporamento stesso.

La policy del tuo wiki potrebbe limitare l'utilizzo del parametro di collegamento alternativo, o potrebbe addirittura imporre un divieto per i parametri di collegamento alternativi per i file multimediali incorporati (nel quale caso, il parametro di collegamento sarà ignorato), o potrebbe solo accettarli dopo una convalida da parte di utenti autorizzati o amministratori.

Renderizzare una galleria di immagini

Sintassi della galleria

È facile realizzare una galleria di anteprime con il tag ‎<gallery>. La sintassi è:

<gallery>
File:file_name.ext|caption|alt=alt language
File:file_name.ext|caption|alt=alt language
{...}
</gallery>

Da notare che il codice dell'immagine non è racchiuso tra le parentesi quando sono racchiusi nei tag di galleria.

Le didascalia sono opzionali, e possono contenere link di wiki o altre formattazioni.

Le parole "center", "left", e "right" usate come didascalie causano errori di Linter falsi positivi. Vedere task T275074 per dettagli.

Alcuni dei parametri che controllano l'output dell'anteprima possono essere utilizzati qui, specificatamente quelli che modificano il file (al contrario di quelli che controllano dove si posiziona l'immagine nella pagina). Per esempio, con supporti multi-pagina come i pdf, puoi usare codici come $code.

Il prefisso File: può essere ommesso. Comunque, è d'aiuto includerlo come un aiuto per localizzare velocemente gli specificatori dell'immagine nel wikitext (per esempio, quando si pulisce il layout della pagina).

If the image links to an external site, the caption must come before the link parameter or the caption will not render.

Per esempio:

<gallery>
File:Example.jpg|Item 1
File:Example.jpg|a link to [[Help:Contents]]
File:Example.jpg
File:Example.jpg|alt=An example image. It has flowers
File:Example.jpg|''italic caption''
File:Example.jpg|link=https://example.com|This text will not render because an external link came first
File:Example.jpg|Links to external website|link=https://example.com
File:Example.jpg|link=w:Main_Page|Internal link
Example.jpg|on page "{{PAGENAME}}"
File:Using Firefox.pdf|page=72
</gallery>

è formattato come:

Item 1
a link to Help:Contents
italic caption
Links to external website
Internal link
on page "Images/it"

Parametri mode

Versione MediaWiki:

≥ 1.22

A partire dal 1.22 è disponibile un parametro mode, prendendo le seguenti opzioni:

traditional è il tipo di galleria originale usato da MediaWiki.
nolines è simile a traditional, ma senza linee di bordo.
packed rende le immagini con la stessa altezza ma con differenti larghezze, con poco spazio tra le immagini. Le righe in questa modalità reattiva si organizzano da sole a seconda della larghezza dello schermo.
packed-overlay mostra la didascalia sovrapposta all'immagine, in una casella bianca semi-trasparente.
packed-hover è simile a packed-overlay, ma con la didascalia e la casella che compaiono solo al passaggio del mouse.
slideshow crea una presentazione delle immagini.

Per esempio:

<gallery mode="packed-hover">
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)
File:Pterois volitans Manado-e.jpg|''[[commons:Pterois volitans|Pterois volitans]]'' (Red Lionfish)
File:Macropodus opercularis - front (aka).jpg|''[[commons:Macropodus opercularis|Macropodus opercularis]]'' (Paradise fish)
File:Canthigaster valentini 1.jpg|''[[commons:Canthigaster valentini|Canthigaster valentini]]'' (Valentinni's sharpnose puffer)
File:Flughahn.jpg|[[File:POTY ribbon 2007.svg|25px]] ''[[commons:Dactylopterus volitans|Dactylopterus volitans]]'' (Flying gurnard)
File:Fishmarket 01.jpg|''[[commons:Semicossyphus pulcher|Semicossyphus pulcher]]'' (California Sheephead)
File:Pseudorasbora parva(edited version).jpg|''[[commons:Category:Pseudorasbora parva|Pseudorasbora parva]]'' (Topmouth gudgeon)
File:MC Rotfeuerfisch.jpg|''[[commons:Category:Pterois antennata|Pterois antennata]]'' (Antennata Lionfish)
File:Cleaning station konan.jpg|''[[commons:Novaculichthys taeniourus|Novaculichthys taeniourus]]''
File:Synchiropus splendidus 2 Luc Viatour.jpg|''[[commons:Synchiropus splendidus|Synchiropus splendidus]]'' (Mandarin fish)
File:Psetta maxima Luc Viatour.jpg|''[[commons:Psetta maxima|Psetta maxima]]'' (Turbot)
File:Australian blenny.jpg|''[[commons:Category:Ecsenius|Ecsenius axelrodi]]''
</gallery>

Si ottiene (mode: packed-hover):

Astronotus ocellatus (Oscar)
Salmo salar (Salmon Larva)
Epinephelus lanceolatus (Giant grouper)
Pterois volitans (Red Lionfish)
Macropodus opercularis (Paradise fish)
Canthigaster valentini (Valentinni's sharpnose puffer)
Dactylopterus volitans (Flying gurnard)
Semicossyphus pulcher (California Sheephead)
Pseudorasbora parva (Topmouth gudgeon)
Pterois antennata (Antennata Lionfish)
Novaculichthys taeniourus
Synchiropus splendidus (Mandarin fish)
Psetta maxima (Turbot)
Ecsenius axelrodi

Esempi degli altri modi:

mode="traditional"

Astronotus ocellatus (Oscar)
Salmo salar (Salmon Larva)
Epinephelus lanceolatus (Giant grouper)

mode="nolines"

Astronotus ocellatus (Oscar)
Salmo salar (Salmon Larva)
Epinephelus lanceolatus (Giant grouper)

mode="packed"

Astronotus ocellatus (Oscar)
Salmo salar (Salmon Larva)
Epinephelus lanceolatus (Giant grouper)

mode="packed-overlay"

Astronotus ocellatus (Oscar)
Salmo salar (Salmon Larva)
Epinephelus lanceolatus (Giant grouper)

mode="packed-hover"

Astronotus ocellatus (Oscar)
Salmo salar (Salmon Larva)
Epinephelus lanceolatus (Giant grouper)

Versione MediaWiki:

≥ 1.28

mode="slideshow"

Astronotus ocellatus (Oscar)
Salmo salar (Salmon Larva)
Epinephelus lanceolatus (Giant grouper)
Pterois volitans (Red Lionfish)
Macropodus opercularis (Paradise fish)
Canthigaster valentini (Valentinni's sharpnose puffer)
Dactylopterus volitans (Flying gurnard)
Semicossyphus pulcher (California Sheephead)
Pseudorasbora parva (Topmouth gudgeon)
Pterois antennata (Antennata Lionfish)
Novaculichthys taeniourus
Synchiropus splendidus (Mandarin fish)
Psetta maxima (Turbot)
Ecsenius axelrodi

Attributi di galleria opzionali

Il tag galleria stesso possiede innumerevoli parametri addizionali, specificati come attributi nome-valore accoppiati:

<gallery {parameters}>
{images}
</gallery>

caption="{didascalia}": (il testo della didascalia è tra doppie virgolette quando si tratta di più di una parola) imposta una didascalia centrata sopra la galleria. Solo il testo normale può essere utilizzato nella didascalia; la formattazione, i template e simili non funzionano.
widths={larghezza}px: imposta le (massime) larghezze delle immagini; il valore predefinito è 120px. (Non ha alcun effetto se la modalità è impostata su uno dei seguenti: packed, packed-overlay, packed-hover, slideshow.) Da notare il plurale: widths.
heights={altezza}px: imposta le (massime) altezze delle immagini; il valore predefinito è 120px. (Non ha alcun effetto se la modalità è impostata su slideshow.)
perrow={numero intero}: imposta il numero di immagini per riga. (Non ha alcun effetto se la modalità è impostata su uno dei seguenti: packed, packed-overlay, packed-hover, slideshow.) 0 significa automaticamente regolato basandosi sulla larghezza dello schermo.
showfilename={anything}: mostra i nomi dei file delle immagini nelle didascalie individuali di ogni immagine (1.17+).
mode={traditional|nolines|packed|packed-hover|packed-overlay|slideshow}: vedi la sezione sopra (1.22+; 1.28+ per "slideshow").
showthumbnails: solo per modalità "slideshow", mostra la striscia con le anteprime delle immagini sotto la presentazione in maniera predefinita (1.29+).
Any html attribute allowed on a <ul> tag (e.g. id, title, class)

For packed (and related) modes the widths parameter has no effect and the heights parameter determines the minimum height of the images. Le modalità packed regolano la larghezza delle immagini in modo tale da rendere ogni riga della stessa lunghezza.

Esempio 1

Sintassi:

<gallery widths=300 heights=200>
File:Example.jpg|Lorem ipsum
File:Example.jpg|Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut
</gallery>

Risultato:

Lorem ipsum
Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut

Esempio 2

Sintassi:

<gallery widths=60 heights=60 perrow=7 caption="sunflowers are groovy">
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
</gallery>

Risultato:

sunflowers are groovy

Riga di immagini che va a capo seguendo la larghezza del browser

Un modo per far funziona una riga di immagini con varie larghezze è non utilizzare "thumb" o "left" o "none". Se "thumb" non è utilizzato (e quindi senza didascalie) una riga di immagini va a capo seguendo la larghezza del browser. Se necessario, restringi la finestra del browser per vedere le immagini che vanno a capo alla prossima riga.

[[File:Example.jpg|220px]]
[[File:Example.jpg|100px]]
[[File:Example.jpg|150px]]
[[File:Example.jpg|250px]]
[[File:Example.jpg|200px]]
[[File:Example.jpg|50px]]
[[File:Example.jpg|220px]]
[[File:Example.jpg|175px]]

Per far andare a capo le immagini di varie larghezza con le didascalie è necessario usare un div HTML per una lista non ordinata. Assieme a style="display: inline-block;". Per più informazioni e idee vedere: Give Floats the Flick in CSS Layouts.

<div><ul> 
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|220px|Caption 1]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|100px|Caption 2]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|150px|Caption 3]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|250px|Caption 4]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|200px|Caption 5]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|50px|Caption 6]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|220px|Caption 7]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|175px|Caption 8]] </li>
</ul></div>

Caption 1
Caption 2
Caption 3
Caption 4
Caption 5
Caption 6
Caption 7
Caption 8

Per allineare la parte superiore delle immagini aggiungi un commando di allineamento verticale

<div><ul> 
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|220px|Caption 1]] </li>
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|100px|Caption 2]] </li>
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|150px|Caption 3]] </li>
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|250px|Caption 4]] </li>
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|200px|Caption 5]] </li>
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|50px|Caption 6]] </li>
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|220px|Caption 7]] </li>
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|175px|Caption 8]] </li>
</ul></div>

Caption 1
Caption 2
Caption 3
Caption 4
Caption 5
Caption 6
Caption 7
Caption 8

Alcuni servizi di hosting wiki non hanno tutte le opzioni della galleria (come "widths"). Inoltre, qualche volta si desidera avere larghezze variabili per le immagini su una riga. All'infuori di una galleria, o dal div HTML, è impossibile avere didascalie individuali per le immagini su una riga di immagini che va a capo seguendo la larghezza del browser. Provalo e vedrai. Nient'altro usando wikitext funziona correttamente. Le immagini sovrapporranno parti sulla destra, o forzeranno una barra di scorrimento orizzontale.

Usando un float sinistro ("left") per alcune immagini, combinato con "none" per alcune delle immagini, non funzionerà comunque coerentemente, specialmente se c'è anche una barra laterale destra delle immagini. Possono accadere cose strane. Con browser o larghezze dello schermo più strette un'immagine fuori dalla riga potrebbe comparire molto in basso nella pagina dopo la fine della barra laterale destra delle immagini.

Comportamento dei collegamenti

In maniera predefinita una immagine si collega alla sua pagina di descrizione del file. L'opzione "link=" modifica questo comportamento per collegarlo ad un'altra pagina o sito web, o per disattivare il comportamento di collegamento dell'immagine.

Alternativamente, puoi creare un collegamento di testo ad una pagina di descrizione del file o al file stesso. Vedi Help:Linking to files .

Mostra l'immagine, collegala ad un'altra pagina o sito web

Usa l'opzione "link=" per collegare un'immagine ad un'altra pagina o sito web:

Cliccando sull'immagine sottostante ti porterà a MediaWiki:

[[File:MediaWiki-2020-logo.svg|50px|link=MediaWiki]]

Cliccando sull'immagine sottostante ti porterà a example.com:

[[File:MediaWiki-2020-logo.svg|50px|link=http://example.com]]

Mostra l'immagine, disattiva il collegamento

Usa l'opzione "link=" senza assegnargli un valore per disattivare completamente il collegamento; l'immagine sottostante non è un collegamento:

[[File:MediaWiki-2020-logo.svg|50px|link=]]

Collegamento ad un'immagine

Aggiungi : come prefisso al collegamento che devi creare.

[[:File:MediaWiki-2020-logo.svg]]

File:MediaWiki-2020-logo.svg

[[:File:MediaWiki-2020-logo.svg|Wiki]]

Wiki

Collegare direttamente ad un'immagine

Gli esempi soprastanti collegano alla pagina di descrizione dell'immagine. Per collegare direttamente ad un'immagine, il pseudo namespace Media: può essere utilizzato sulle pagine MediaWiki:

[[Media:MediaWiki-2020-logo.svg]]

Media:MediaWiki-2020-logo.svg

Collegamenti diretti da siti esterni

Un'altra possibilità è utilizzare la pagina Special:Redirect/file (o il suo alias Special:Filepath). Diversamente dall'esempio soprastante, puoi collegarlo da siti web esterni, così come da pagine MediaWiki.

[[Special:Redirect/file/Wikipedia.png]]

I parametri height e width possono anche essere aggiunti per ottenere una dimensione specifica dell'immagine. Il rapporto d'aspetto dell'immagine è sempre preservato.

https://www.mediawiki.org/w/index.php?title=Special:Redirect/file/Wikipedia.png&width=100&height=100

Ottenere l'URL completo di un'immagine

Per ottenere il percorso completo di un'immagine (senza passare attraverso reindirizzamenti come mostrato sopra), alcuni Parole magiche possono essere utilizzati.

{{filepath:MediaWiki-2020-logo.svg}}

Diventa:

//upload.wikimedia.org/wikipedia/commons/d/dd/MediaWiki-2020-logo.svg

Nel caso in cui questo venga utilizzato a partire da un template dove il namespace File: deve essere rimosso, {{PAGENAME}} può farlo:

{{filepath:{{PAGENAME:File:MediaWiki-2020-logo.svg}}}}

Diventa:

//upload.wikimedia.org/wikipedia/commons/d/dd/MediaWiki-2020-logo.svg

File in altri siti web

Puoi collegarlo ad un file esterno disponibile online usando la stessa sintassi utilizzata per collegarlo ad un sito web esterno. Con queste sintassi, l'immagine non sarà renderizzata, ma solo il testo del collegamento a questa immagine verrà mostrata.

[http://url.for/some/image.png]

O mostrando un testo alternativo:

[http://url.for/some/image.png collega il testo qua]

Markup aggiuntivi di MediaWiki o di formattazione HTML/CSS (per elementi in linea) sono permessi in questo testo visualizzato (con l'eccezione di collegamenti incorporati che disturberebbero il collegamento circostante):

[http://www.example.com/some/image.png Esempio '''<del>ricco</del>''' ''<ins>testo del collegamento</ins>'' qua.]

che si renderizza come: Esempio ~~ricco~~ testo del collegamento qua.

Se è abilitato nel tuo wiki (vedi Manual:$wgAllowExternalImages ), puoi anche incorporare immagini esterne. Per fare ciò, inserisci l'URL dell'immagine:

http://url.for/some/image.png

Le immagini incorporate possono essere ridimensionate dalla proprietà CSS transform. Possono anche essere formattate dai markup MediaWiki circostanti o codice HTML/CSS.

Se questa opzione wiki non è abilitata, l'immagine non verrà incorporata ma renderizzata come un collegamento testuale al sito esterno, esattamente come sopra, a meno che il Manual:$wgAllowExternalImagesFrom del sito abbia un valore.

It is also possible to use InstantCommons (enabled by default) or other shared file repositories to load files from other wikis, which are treated as if they were local images.

Vedi anche

[1] Manual:$wgParserEnableLegacyMediaDOM

[2] Parsoid/Parser Unification/Media structure/FAQ#The %7Cclass= media option is now applied to the wrapper

[1]

[2]

Formato	Ridotto	Allargato
(not specified)	[[File:example.jpg\|50px]]	[[File:example.jpg\|500px]]
border	[[File:example.jpg\|border\|50px]]	[[File:example.jpg\|border\|500px]]
frame	[[File:example.jpg\|frame\|50px]]	[[File:example.jpg\|frame\|500px]]
thumb	[[File:example.jpg\|thumb\|50px]]	[[File:example.jpg\|thumb\|500px]]
frameless	[[File:example.jpg\|frameless\|50px]]	[[File:example.jpg\|frameless\|500px]]