Immagini singole
Per inserire un'immagine nella pagina si deve utilizzare la seguente sintassi:
[[image fonte-immagine attributo1="valore1" attributo2="valore2" ...]]
Questo è l'elenco degli attributi consentiti:
| nome attributo | valore consentito | esempio | descrizione |
|---|---|---|---|
| link | nome della pagina wiki o URL | "wiki-page" "http://www.example.com" |
Trasforma l'immagine in un collegamento a un'altra pagina o indirizzo web; questo attributo viene ignorato se si utilizza come fonte il sito Flikr; anteporre al link il simbolo "*" per fare aprire il collegamento in una nuova pagina |
| alt | qualsiasi stringa | "una mia fotografia" | testo che apparirà se l'immagine non è disponibile |
| width | numero di pixels | "200px" | forza la larghezza dell'immagine che viene mostrata |
| height | numero di pixels | "200px" | forza l'altezza dell'immagine che viene mostrata |
| style | definizione di stile CSS valido | "border: 1px solid red; padding: 2em;" | aggiunge un ulteriore stile CSS all'immagine |
| class | classe CSS | "miostile" | forza la classe CSS dell'immagine - se ne suggerisce l'utilizzo solo con i temi personalizzati |
| size | "square" - 75x75 pixels "thumbnail" - 100 sul lato più lungo "small" - 240 sul lato più lungo "medium" - 500 sul lato più lungo "large" - 1024 sul lato più lungo (only for Flickr large images) "original" - immagine originale (solo per il sito Flickr) |
qualunque fra quelli consentiti ;-) | mostra l'immagine ridimensionata; ottimo per le anteprime se la fonte è Flickr questo attributo non ha effetti |
l'attributo size funziona molto bene con i file locali (queli allegati alle pagine) non solo con i file immagine, ma ad es. anche con i PDF o PostScript.
Vedi questa pagina per ulteriori dettagli.
La fonte-immagine può essere una delle seguenti:
| tipo fonte | formato | esempio | descrizione |
|---|---|---|---|
| indirizzo URL | qualunque indirizzo URL valido | http://www.esempio.com/immagine.jpg | mostra l'immagine da una pagina web |
| file allegato (pagina corrente) | nomefile | immagineesempio.jpg | mostra l'immagine allegata alla pagina corrente |
| file allegato (pagina diversa) | /nome-altra-pagina/nomefile | /altra-pagina/immagineesempio.jpg | mostra l'immagine allegata in un altra pagina |
| immagine flickr | flickr:fotoid | flickr:83001279 | mostra l'immagine dal sito Flickr e linka alla pagina Flikr originale |
| immagine flickr (privata) | flickr:fotoid_riservato | flickr:149666562_debab08866 | mostra l'immagine ospitata su Flickr e linka alla pagina originale; se viene fornito il riservato l'immagine viene visualizzata anche se è contrassegnata come non pubblica |
Per fare aprire il documento in una nuova finestra è possibile anteporre all'attributo link il simbolo '*' (es. link="*http://www.esempio.com" o il simbolo "*" all'elemento src (es. *flickr:149666562_debab08866, *file-immagine ecc.) per le immagini che generano automaticamente dei collegamenti.
Per scegliere l'allineamento orizzontale utilizzate:
- [[=immagine… - immagine centrata
- [[<immagine… - immagine allineata a sinistra
- [[>immagine… - immagine allineata a destra
- [[f<immagine… - immagine fluttuante a sinistra (circondata dal testo)
- [[f>immagine… - immagine fluttuante a destra (circondata dal testo)
Galleria di immagini
Per inserire una serie di immagini all'interno di una pagina, si deve utilizzare l'elemento: [[gallery]]
[[gallery size="dimensione-immagine"]]
oppure
[[gallery size="dimensione-immagine"]]
: fonte-immagine1 attributo1="valore1" attributo2="valore2" ...
: fonte-immagine2 attributo1="valore1" attributo2="valore2" ...
...
[[/gallery]]
L'unico attributo consentito all'interno del tag [[gallery]] è size che accetta solo i seguenti valori: "square", "thumbnail", "small", "medium".
Se viene utilizzato il tag [[gallery]] senza un elenco di immagini, automaticamente verranno mostrate delle immagini ridimensionate (thumbnails) dei file allegati alla pagina corrente (comprese anteprime di file .pdf o .ps).
Se al contrario viene utilizzato il tag [[gallery]] con un elenco di immagini, nella pagina verranno mostrate solo queste. image-source in questo caso non deve essere un URL.
Gli attributi consentiti "per immagine" sono:
- link - URL o nome della pagina wiki (come da termini del servizio non funziona con le immagini ospitate su Flickr)
- alt - testo alternativo quando l'immagine non è disponibile
Per fare aprire un documento in un'altra finestra valgono le stesse regole citate per le immagini singole.
Vedere anche Modulo FlickrGallery se si vogliono importare immagini da Flickr.