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).
 * * .png : immagini bitmap in formato Portable Network Graphics (specifica del W3 Consortium).
 * - * .gif : 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 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 similare. 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 (""|""):


 * Opzioni di formato: uno di border e/o frameless, frame, thumb (o thumbnail). Se sono presenti più opzioni, il rendering dell'immagine potrebbe essere inaspettato.
 * 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. (È 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.
 * {larghezza}x{altezza}px — Ridimensiona l'immagine per adattarla all'interno della larghezza e dell'altezza massima data in pixel.
 * 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  ).
 * Se entrambi  e   sono presenti, il primo   sarà ignorato. Vedi  per i dettagli.
 * Se è presente un carattere di spazio vuoto tra "upright" e il segno di uguale (per esempio ), o se il valore di "upright" contiene caratteri non numerici, il valore di   sarà ignorato). Vedi  per i dettagli.
 * 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 Link: 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 T216003).


 * ! 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 di 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 l'altezza di linea 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 è:

Mode parameter
Starting in 1.22 a  parameter is available, taking options as follows:

The rows in this responsive mode organize themselves according to the width of the screen.
 * is the original gallery type used by MediaWiki.
 * is similar to, but with no border lines.
 * causes images to have the same height but different widths, with little space between the images.
 * shows the caption overlaid on the image, in a semi-transparent white box.
 * is similar to, but with the caption and box only showing up on hover.
 * crea una presentazione delle immagini.

Per esempio:

Gives (mode: ):

Optional gallery attributes
The gallery tag itself takes several additional parameters, specified as attribute name-value pairs:

Row of images that will wrap to browser width
One way that works for a row of images with varying widths is not to use "thumb" or "left" or "none". If "thumb" is not used (and thus no captions) a row of images will wrap to the browser width. If necessary, narrow the browser window to see the images wrap to the next row.





To wrap images of varying widths with captions it is necessary to use div HTML for an unordered list. Along with. For more info and ideas see: Give Floats the Flick in CSS Layouts.

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

To align the top edge of images add the vertical-align command

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

Some wiki farms do not have all gallery options (such as "widths"). Also, sometimes one wants varying widths for images in a row. Outside of a gallery, or the div HTML, it is impossible to have individual captions for images in a row of images that will wrap to the browser width. Try it and see. Nothing else using wikitext works correctly. Images will either overlap stuff on the right, or force a horizontal scroll bar.

Using a left float ("left") for some images, combined with "none" for some of the images, will not work consistently either, especially if there is also a right sidebar of images. Possono accadere cose strane. At narrower browser or screen widths an image out of the row may appear far down the page after the end of the right sidebar of images.

Comportamento dei link
By default an image links to its file description page. The "link=" option modifies this behavior to link to another page or website, or to turn off the image's linking behavior.

Alternatively, you can create a text link to a file description page or to the file itself. Vedi.

Mostra l'immagine, collegala ad un'altra pagina o sito web
Use "link=" option to link image to another page or website:

Clicking on the below image will take you to MediaWiki:





Clicking on the below image will take you to example.com:





Display image, turn off link
Use "link=" option with no value assigned to turn link off entirely; the below image is not a link:





Link ad un'immagine
Add  as a prefix to the link you need to create.

File:Wiki.png File:Wiki.png Wiki Wiki

Link diretto ad un'immagine
The above examples link to the image's description page. To directly link to an image, the pseudo-namespace  can be used on MediaWiki pages:

[[Media:Wiki.png]]

Link diretti da siti esterni
Another possibility is to use the Special:Redirect/file page (or its alias Special:Filepath). Unlike the above example, you can link to it from external websites as well as from MediaWiki pages.

The parameters  and   can also be added to return a specific size of the image. The image aspect ratio is always preserved.

Obtaining the full URL of an image
To obtain the full path of an image (without going through redirects as shown above), some can be used.

Diventa:



In the event that this is used from a template where the  namespace needs to be removed,   can do so:

Diventa:



Requisiti
Before using images in your page, the system administrator of your wiki must have enabled file uploads and a user has to upload the file. System administrators may also set the wiki to accept files from foreign repositories, such as the Wikimedia Commons. For server side image resizing it is necessary to have a scaler configured (such as GD2, ImageMagick, etc.).

Files at other websites
You can link to an external file available online using the same syntax used for linking to an external web page. With these syntaxes, the image will not be rendered, but only the text of the link to this image will be displayed.



Or with a different displayed text:

link text here

Additional MediaWiki markup or HTML/CSS formatting (for inline elements) is permitted in this displayed text (with the exception of embedded links that would break the surrounding link):

Example  rich   link text  here.

which renders as: [http://www.example.com/some/image.png Example  rich   link text  here. ]

If it is enabled on your wiki (see ), you can also embed external images. To do that, simply insert the image's URL: http://url.for/some/image.png Embedded images can be resized by the CSS  property. They also may be formatted by surrounding MediaWiki markup or HTML/CSS code.

If this wiki option is not enabled, the image will not be embedded but rendered as a textual link to the external site, just like above, unless the site's has a value.

Vedi anche

 * Wikipedia:Extended image syntax
 * Category:Wikipedia image help
 * Wikipedia:Picture tutorial
 * w:Help:Gallery tag
 * T113101 - responsive issues
 * T113101 - responsive issues