XWiki Syntax Guide

XWiki Syntax 2.1 » Modifica » Immagini

XWiki Syntax 2.1: Immagini

2.1 Images

CaratteristicaSintassi XWiki 2.1Risultato
Immagine da un allegato nella pagina correnteimage:img.pngimg.png
Immagine da un allegato di un altro documentoimage:Space.Page@img.pngimg.png
Immagine con parametri[[image:img.png||width="25" height="25"]]img.png
Immagini raggiungibili con un URLimage:http://some/url/img.pngimg.png
Iconaimage:icon:acceptaccept

Specifiche per le Immagini in Sintassi XWiki 2.1

Il formato completo di un'immagine è image: (riferimento) oppure [[image: (riferimento) {||parametri}]]

  • image: Stringa richiesta che identifica la risora come immagine.
  • riferimento: Il riferimento all'immagine che sarà mostrata in una delle forme seguenti:
    • URL: Un qualunque URL ad un'immagine nel formato protocollo://percorso/Nomeimmagine. Esempio: http://domain.org/path/img.png
    • Allegato riferimento nel formato {{{Nomewiki:} spazio.} pagina@} (Nomeimmagine)
      • NomeWiki: Stringa opzionale che contiene il nome di un subwiki (animal) di una 'farm' di wiki. Il link punterà ad una pagina all'interno di quel subwiki. Esempio: miowiki
      • spazio: Nome opzionale di uno spazio del wiki. Se non si specifica uno spazio viene usato lo spazio corrente. Esempio: Main
      • pagina: Stringa opzionale che contiene il nome di una pagina del wiki a cui l'immagine fa riferimento come allegato. Esempio: WebHome
      • Nomeimmagine: Stringa richiesta con il nome dell'immagine allegata alla pagina così come è memorizzato nel wiki.
    • Icona riferimento nel formato (icon:) (iconName). Esempio: icon:accept
      • icon: Stringa richiesta che identifica il riferimento come un'icona da XWiki Icon Set.
      • iconName: Stringa richiesta che identifica l'icona cui si fa riferimento. Esempio: accept
  • parametri: Elenco opzionale di parametri separati da uno spazio passati all'immagine. Esempio: width="800" height="600" alt="img.png" title="My nice image"
    • Attributi HTML: Tutti gli attributi definiti dallo standard HTML saranno aggiunti al codice HTML renderizzato <img> tag.
      • style: Informazioni sullo stile CSS che si deve applicare all'immagine. Esempio: style="float:right;height:50" (immagina a destra, altezza 50 pixel), style="display:block;margin-left:auto;margin-right:auto;width:80%" (immagine centrata, larghezza 80% del blocco), style="vertical-align:bottom" (il testo inzia in basso all'immagine)
      • height: Parametro che definisce l'altezza visualizzata dell'immagine. Il valore dovrebbe essere in pixel (esempio: height="80") o in pixel relativi all'altezza del blocco contenente l'immagine (esempio: height="40%").
      • width: Parametro che definisce la larghezza visualizzata dell'immagine. Il valore dovrebbe essere in pixel (esempio: width="80") o in pixel relativi alla larghezza del blocco contenente l'immagine (esempio: width="40%").
      • title: Parametro che definisce il titolo visualizzato dell'immagine che sarà visibile quando ci si passa sopra con il mouse, per esempio. Esempio: title="La mia bella immagine"
      • alt: Parametro che definisce quale testo deve essere mostrato se il browser non è in grado di visualizzare l'immagine. Dal momento che questo è un attributo HTML richiesto XWiki userà il nome del file se il parametro alt non è definito. Esempio: alt="img.png"
      • Altro: Una spiegazione più approfondita sul tag HTML <img> tag che comprende altri attributi si può trovare su on w3.org.
    • queryStringa: Consente di inviare richieste al server quando si crea il link per il download dell'immagine referenziata. Esempio: queryString="width=100&height=800&keepAspectRatio=true" (keepAspectRatio=true non avrà successo se i parametri width e height non vengono specificati oltre a queryString!)