XWiki - XWiki Syntax Guide

Page / - ultima modifica di Fabio Scubla il 2022/08/01 16:14

XWiki Syntax Guide

ultima modifica di Fabio Scubla

il 2022/08/01 16:14

Indice

XWiki Syntax 2.1: Immagini

XWiki Syntax 2.1 » Modifica » Immagini

XWiki Syntax 2.1: Immagini

Generale

Preliminare

Considerazioni Generali

Altre sintassi

Modifica

Paragrafi

Titoli

Formattazione Testo

Riga Orizzontale

Elenchi

Elenchi di Definizione

Nuova riga/Interruzioni di riga

Collegamenti - Links

Tabelle

Immagini

Avanzato

Verbatim

Citazioni

Gruppi

Escapes

Parameters

Programmazione

Macro

HTML

Scripts

2.1 Images

Caratteristica	Sintassi XWiki 2.1	Risultato
Immagine da un allegato nella pagina corrente	image:img.png
Immagine da un allegato di un altro documento	image:Space.Page@img.png
Immagine con parametri	[[image:img.png||width="25" height="25"]]
Immagini raggiungibili con un URL	image:http://some/url/img.png
Icona	image:icon:accept

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