Help:Images/it

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 che sono memorizzate su un server MediaWiki sono solitamente mostrate utilizzando il prefisso namespace  (ma anche il vecchio prefisso namespace   è ancora supportato come sinonimo) come destinazione per un link MediaWiki. Il prefisso namespace alternativo  è anche usato come riferimento al contenuto del file multimediale originale (per renderlo visibile o scaricarlo separatamente, fuori da una pagina MediaWiki).

Tipi di file supportati per le immagini
I seguenti formati di file sono supportati in maniera predefinita:


 * o  - immagini bitmap compresse nel formato JPEG standard (questo formato è a perdita di qualità ed è più adatto per fotografie).
 * - - immagini bitmap in formato Portable Network Graphics (specifica del W3 Consortium).
 * - immagini bitmap nell'obsoleto formato Graphics Interchange Format.

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


 * - immagini scalabili nel formato Scalable Vector Graphics (specifica del W3 Consortium). Vedi Manuale:Amministrazione delle Immagini#SVG.
 * - Tagged Image File Format. Spesso utilizzato in immagini di archivio ad alta risoluzione. Spesso utilizzato con.
 * ,,   - file multimediali Ogg (audio o video). Non è un formato immagine, ma è trattato in maniera simile. Spesso usato con
 * - documenti a più pagine nel formato Portable Document Format (inizialmente su specifiche di Adobe). Spesso usato insieme a
 * - documenti a più pagine nel formato "DejaVu" (molto spesso scansioni di libri). Vedi
 * Solo una singola pagina di un file  o   è mostrato alla volta.

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

Sintassi
La sintassi completa per mostrare un'immagine è:

dove le "opzioni" possono essere zero o più dei seguenti, separati dalle barre verticali (""|""):

Note: border can be used in combination with frameless but will be ignored if used with one of the other options.
 * Opzioni di formato: uno di border e/o frameless, frame, thumb (o thumbnail).
 * Controlla come l'immagine renderizzata è formattata e 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. ( Only whole-number pixel values are supported. È permesso un carattere di spazio vuoto 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. Only whole-number pixel values are supported. A space character between the height value and "px" is permitted.
 * {larghezza}x{altezza}px — Ridimensiona l'immagine per adattarla all'interno della larghezza e dell'altezza massima data in pixel. Only whole-number pixel values are supported. A space character between the width value and "px" is permitted.
 * upright — Ridimensiona un'immagine per adattarla a dimensioni ragionevoli, secondo le preferenze dell'utente (adatto per immagini la cui altezza è maggiore della larghezza). Impostando  mostrerà l'immagine alla larghezza predefinita dell'utente.   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 ridotti di dimensione, ma non incrementati; per esempio, le immagini bitmap non possono essere ingrandite.
 * L'impostazione  non richiede il simbolo di uguaglianza, ossia   funziona come.
 * Quando utilizzato senza un valore o un segno di uguale (per esempio, ), si porta di default a   (anche se   equivale a  ).
 * La massima dimensione predefinita dipende dal "formato" e dalle dimensioni interne dell'immagine (a seconda del tipo di supporto).
 * L'opzione di allineamento orizzontale: uno di left, right, center, none. Se sono presenti più opzioni, solo il primo verrà utilizzato.
 * Controlla l'allineamento orizzontale (e gli stili in linea/a blocco o fluttuante) dell'immagine all'interno di un testo (senza valore predefinito).
 * L'opzione di allineamento verticale: uno di 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 il target (ad un titolo di pagina arbitrario, o l'URL) del link generato, attivabile sulla superficie dell'immagine renderizzata; per esempio  diventa Example.jpg (link esterno), o   diventa Example.jpg (link interno).
 * link= (con un valore nullo) — (MediaWiki 1.14+) Mostra un'immagine senza alcun link attivabile; per esempio   diventa Example.jpg.
 * Se è presente un carattere di spazio vuoto tra  e il segno di uguale, l'indirizzo del collegamento verrà visualizzato come una didascalia.
 * Includendo alcuni caratteri HTML equivalenti, come  per , può causare la trasformazione dell'indirizzo del collegamento in una didascalia (vedi T306216).


 * ! per MW 1.24 e più basso: Se imposti  (vuoto), allora   non verrà renderizzato. (Vedi T23454.)
 * Altre opzioni specifiche:
 * alt={testo alternativo} — (MediaWiki 1.14+) Definisce il testo alternativo (associato all'attributo HTML  dell'elemento   generato) 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  e il segno di uguale, l'espressione alt verrà visualizzata come una didascalia.
 * page={numero} — Renderizza il numero di pagina specificato (al momento applicabile solo quando si mostra un file .djvu o .pdf).
 * class={classe html} — (MediaWiki 1.20+) Definisce classi (associato all'attributo HTML  dell'elemento  generato).
 * lang={codice della lingua} — (MediaWiki 1.22+) Per file SVG che contengono affermazioni &lt;switch&gt; 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.

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, 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, 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.

Negli esempi di seguito, la dimensione originale dell'immagine è 400 × 267 pixel.
 * Per come potrebbe apparire quando la dimensione non è specificata, vedere la sezione Formato sopra.
 * Quando il formato non è specificato, o è solo incorniciato con, la dimensione può essere sia ridotta che allargata a qualunque dimensione indicata.
 * Un'immagine con  ignora sempre l'indicazione della dimensione, l'immagine originale sarà ridotta se eccede la dimensione massima definita nelle preferenze dell'utente.
 * La dimensione di un'immagine con   o   può essere ridotta, ma non può essere aumentata oltre la dimensione originale dell'immagine.

Allineamento orizzontale
Da notare che quando si usano i formati  o , l'allineamento orizzontale predefinito è.

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



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:


 * 1) 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:
 * 2) * 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.
 * 3) * la spaziatura di riga addizionale che potrebbe essere aggiunta da apici e pedici.
 * 4) 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).
 * 5) 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.
 * 6) 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.
 * 7) 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   (o se preferisci, ) 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, che cancella tutti i float dentro all'elemento  .)

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.

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.

Sintassi della galleria
È facile realizzare una galleria di anteprime con il tag. La sintassi è:

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.

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.

Il prefisso  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).

Per esempio:

è formattato come:

Modalità dei parametri
A partire dal 1.22 un parametro $mode è disponibile, le opzioni sono come segue:

Le righe in questa modalità reattiva si organizzano da sole a seconda della larghezza dello schermo.
 * $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.
 * $overlay mostra la didascalia sovrapposta all'immagine, in una casella bianca semi-trasparente.
 * $hover è simile a $overlay, ma con la didascalia e la casella che compaiono solo al passaggio del mouse.
 * $slideshow crea una presentazione delle immagini.

Per esempio:

Si ottiene (mode: ):

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


 * : (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.
 * : imposta le (massime) larghezze delle immagini; il valore predefinito è 120px. Da notare il plurale: widths.
 * : imposta le (massime) altezze delle immagini; il valore predefinito è 120px.
 * : imposta il numero di immagini per riga. 0 significa automaticamente regolato basandosi sulla larghezza dello schermo.
 * : mostra i nomi dei file delle immagini nelle didascalie individuali di ogni immagine (1.17+).
 * : vedi la sezione sopra (1.22+; 1.28+ per "slideshow").
 * : solo per modalità "slideshow", mostra la striscia con le anteprime delle immagini sotto la presentazione in maniera predefinita (1.29+).


 * Example 1

Syntax:

Result:

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.





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. Per più informazioni e idee vedere: Give Floats the Flick in CSS Layouts.

        </li>  </li>  </li>  </li>  </li> </ul>

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

<ul>  </li>  </li>  </li>  </li>  </li>  </li>  </li>  </li> </ul>

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.

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:





Cliccando sull'immagine sottostante ti porterà a 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:





Collegamento ad un'immagine
Aggiungi  come prefisso al collegamento che devi creare.

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  può essere utilizzato sulle pagine MediaWiki:

[[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.

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

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

Diventa:



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

Diventa:



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.).

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.



O mostrando un testo alternativo:

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):

Esempio  ricco   testo del collegamento  qua.

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

Se è abilitato nel tuo wiki (vedi ), 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. 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 del sito abbia un valore.

Vedi anche

 * Wikipedia:Extended image syntax
 * Category:Wikipedia image help
 * Wikipedia:Picture tutorial
 * w:Help:Gallery tag
 * T113101 - problemi reattivi
 * Extension:PageImages
 * Extension:PageImages