XWiki Syntax Guide

XWiki Syntax 2.0: Modifica

Paragrafi

2.0 Paragraphs

I paragrafi sono elementi di testo separati da 2 o più righe vuote.

Nella nuova Sintassi XWiki 2.0 le nuove righe sono rispettate al contrario della Sintassi XWiki 1.0 e della sintassi di Creole.

Caratteristica	Sintassi XWiki 2.0	Risultato
Semplice paragrafo	Questo è un paragrafo	Questo è un paragrafo
Paragrafo su più righe	Paragrafo su più righe	Paragrafo su più righe
Due paragrafi	Paragrafo uno Paragrafo due	Paragrafo uno Paragrafo due
Paragrafo con parametri	(% style="text-align:center;color:blue" %) Paragrafo centrato e blu	Paragrafo centrato e blu

Titoli

2.0 Headings

Caratteristica	Sintassi XWiki 2.0	Risultato
Titoli Standard	= livello 1 = == livello 2 == === livello 3 === ==== livello 4 ==== ===== livello 5 ===== ====== livello 6 ======	livello 1 livello 2 livello 3 livello 4 livello 5 livello 6
Titoli con Parametri	(% style="color:blue" %) = titolo =	titolo
Titoli con sintassi XWiki	=== Titolo con grassetto ===	Titolo con grassetto

Formattazione Testo

2.0 Text Formatting

Novità della Sintassi XWiki 2.0 rispetto alla Sintassi XWiki 1.0:

Sono consentiti degli spazi subito dopo il simbolo sintattico (per esempio in Sintassi XWiki 1.0, questo non era possibile: * grassetto *).
Uso di doppi simboli quando nella Sintassi XWiki 1.0 ce n'era solo uno cosicché è meno probabile che l'utente li usi erroneamente nel testo.
Possibilità di dividere il testo su più righe (non era possibile con la Sintassi XWiki 1.0).

Caratteristica	Sintassi XWiki 2.0	Risultato
Grassetto	Grassetto	Grassetto
Sottolineato	__Sottolineato__	Sottolineato
Corsivo	//Corsivo//	Corsivo
Sbarrato	--Sbarrato--	~~Sbarrato~~
Monospazio	##Monospazio##	Monospazio
Apice	testo ^^in apice^^	testo ^{in apice}
Pedice	testo ,,in pedice,,	testo _{in pedice}

Riga Orizzontale

2.0 Horizontal Line

Ci devono essere 4 o più lineette.

Notare la differenza con Creole in cui ci devono essere esattamente 4 lineette.

Caratteristica	Sintassi XWiki 2.0	Risultato
Riga Orizzontale semplice	----
Riga Orizzontale con Parametri	(% style="color:blue" %) ----

Elenchi

2.0 Lists

Alcuni degli stili mostrati non funzionano con tutti i browser. Per un elenco completo seguire questo link.

Caratteristica	Sintassi XWiki 2.0	Risultato
Elenco puntato	* voce 1 voce 2 * voce 3 * voce 4	voce 1 voce 2 voce 3 voce 4
Elenco numerato	1. voce 1 11. voce 2 111. voce 3 1. voce 4	voce 1 voce 2 voce 3 voce 4
Elenco misto	1. voce 1 1. voce 2 1. voce 3 1. voce 4	voce 1 voce 2 voce 3 voce 4
Elenco puntato con quadratino	(% style="list-style-type: square" %) * voce 1 * voce 2	voce 1 voce 2
Elenco puntato con punto pieno	(% style="list-style-type: disc" %) * voce 1 * voce 2	voce 1 voce 2
Elenco alfabetico minuscolo	(% style="list-style-type: lower-alpha" %) * voce 1 * voce 2	voce 1 voce 2
Elenco alfabetico Maiuscolo	(% style="list-style-type: upper-alpha" %) * voce 1 * voce 2	voce 1 voce 2
Elenco con numeri Romani minuscoli	(% style="list-style-type: lower-roman" %) * voce 1 * voce 2	voce 1 voce 2
Elenco con numeri Romani Maiuscoli	(% style="list-style-type: upper-roman" %) * voce 1 * voce 2	voce 1 voce 2
Elenco con lettere Greche minuscole	(% style="list-style-type: lower-greek" %) * voce 1 * voce 2	voce 1 voce 2
Elenco con lettere Greche Maiuscole	(% style="list-style-type: upper-greek" %) * voce 1 * voce 2	voce 1 voce 2
Elenco Giapponese Hiragana	(% style="list-style-type: hiragana" %) * voce 1 * voce 2	voce 1 voce 2
Elenco Giapponese Hiragana Iroha	(% style="list-style-type: hiragana-iroha" %) * voce 1 * voce 2	voce 1 voce 2
Elenco Giapponese Katakana	(% style="list-style-type: katakana" %) * voce 1 * voce 2	voce 1 voce 2
Elenco Giapponese Katakana Iroha	(% style="list-style-type: katakana-iroha" %) * voce 1 * voce 2	voce 1 voce 2
Elenco lettere Armene	(% style="list-style-type: armenian" %) * voce 1 * voce 2	voce 1 voce 2
Elenco lettere Ebraiche	(% style="list-style-type: hebrew" %) * voce 1 * voce 2	voce 1 voce 2
Elenco lettere Georgiane	(% style="list-style-type: georgian" %) * voce 1 * voce 2	voce 1 voce 2
Elenco ideogrammi Cinesi CJK	(% style="list-style-type: cjk-ideographic" %) * voce 1 * voce 2	voce 1 voce 2

Elenchi di Definizione

2.0 Definition Lists

Caratteristica	Sintassi XWiki 2.0	Risultato
Definizione Standard	; termine : definizione	termine definizione
Definizioni Nidificate	; termine1 : definizione1 :; termine2 :: definizione2	termine1 definizione1 termine2 definizione2
Definizione con Parametri	(% style="color:blue" %) ; termine : definizione	termine definizione

Nuova riga/Interruzioni di riga

2.0 New Line Line Breaks

Una nuova riga è un ritorno a capo. Un'interruzione di riga è una nuova riga forzata che può comparire in un punto qualsiasi del testo.

Con la Sintassi XWiki 2.0 le nuove righe vengono rispettate, cosa che non accade con la Sintassi XWiki 1.0 e con la Sintassi di Creole.

Caratteristica	Sintassi XWiki 2.0	Risultato
Interruzione riga	Riga\\Nuova riga	Riga Nuova riga
Nuova riga	Riga Nuova riga	Riga Nuova riga

Collegamenti - Links

2.0 Links

Caratteristica	Sintassi XWiki 2.0	Risultato
Link ad una pagina nello Spazio corrente	[[WebHome]]	XWiki
Link con etichetta	[[etichetta>>WebHome]] La sintassi XWiki è supportata anche all'interno delle etichette	etichetta
Link con sintassi XWiki nell'etichetta	[[etichetta in grassetto>>WebHome]]	etichetta in grassetto
Link ad una pagina di uno spazio specificato	[[Main.WebHome]]	Main
Link ad un subwiki	[[subwiki:Main.WebHome]]	Main
Link che si apre in una nuova pagina	[[etichetta>>WebHome\|\|rel="__blank"]]	etichetta
Link ad un URL direttamente nel testo	Questo è un URL: http://xwiki.org	Questo è un URL: http://xwiki.org
Link ad un URL	[[http://xwiki.org]]	http://xwiki.org
Link ad un URL con etichetta	[[XWiki>>http://xwiki.org]]	XWiki
Link ad un indirizzo email	[[john@smith.net>>mailto:john@smith.net]]	john@smith.net
Link ad un'immagine	[[image:Space2.Page2@img.png>>Space1.Page1]]
Link ad un'immagine con parametri	[[[[image:Space2.Page2@img.png\|\|width="26" height="26"]]>>Space1.Page1]]
Link ad un allegato nella pagina corrente	[[text>>attach:img.png]]	text
Link ad un allegato in una pagina diversa	[[text>>attach:Space.Page@img.png]]	text
Link ad una Ancora in una pagina	[[label>>Space.Page#anchor]]	label
Link ad un Titolo in una pagina	[[label>>Space.Page#HMyheading]]	label

Quando s'inserisce un Titolo, si crea un'ancora di nome "H" seguita dal testo dell'intestazione di sole lettere. Per esempio, per Titolo "My heading", l'ancora generata sarà "HMyheading".

Specifiche dei link con la Sintassi XWiki 2.0

The part in ( ) is required, while the parts in [ ] are optional.

Le parti tra ( ) sono richieste, le parti tra [ ] sono opzionali.

Il formato completo di un link è [etichetta>>] (risorsa) [@interWikiAlias] [||parametri]

etichetta: Stringa opzionale che sarà mostrata all'utente dopo il render del link. L'etichetta può contenere della sintassi XWiki. Se non viene specificata un'etichetta sarà generata un'etichetta predefinita. Il modello di generazione può essere cambiato, vedere la Admin Guide. Esempio: My Page
risorsa: Il riferimento completo al link con la sintassi seguente: (riferimento) [?Stringaquery] [#ancora]
- riferimento: Il riferimento al collegamento in una delle forme seguenti:
  - URL: qualsiasi URL nella forma protocollo://percorso. Esempi: http://xwiki.org, https://svn.xwiki.org/
  - Nome pagina Wiki riferimento nella forma [[NomeWiki:] spazio.] (pagina). Esempi: WebHome, Main.WebHome, mywiki:Main.WebHome
    - 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 verrà usato lo spazio corrente. Esempio: Main
    - pagina: Stringa obbligatoria che contiene il nome della pagina del wiki cui si vuole collegarsi. Esempio: WebHome
  - Allegato riferimento nella forma attach: [wikiPageName@] (attachmentName). Esempi: attach:img.png, attach:mywiki:Main.WebHome@img.png
    - attach:: Stringa richiesta che identifica la risorsa come allegato.
    - wikiPageName: Stringa opzionale con il riferimento al documento che contiene l'allegato, vedere sopra "Wiki page name".
    - attachmentName: Nome dell'allegato come è stato memorizzato nel wiki.
  - indirizzo Email nella forma mailto: (emailAddress) (#anchor non è valido). Esempio: mailto:john@smith.com
    - mailto:: Stringa richiesta che identifica la risorsa come email.
    - emailAddress: Indirizzo del destinatario dell'email. Esempio: "john@smith.com"
- Stringaquery: Stringa opzionale di query per specificare parametri che saranno usati nel rendering dell'URL. Esempio: mydata1=5&mydata2=Hello
- anchra: Nome di un'ancora opzionale che punta ad un'ancora definita nel link cui si fa riferimento. Notare che in XWiki le ancore sono create automaticamente per i titoli. Esempio: HTableOfContents
interWikiAlias: Alias opzionale Inter Wiki come definito nella InterWiki Map (vedere la Admin Guide). Questo vale solo per i nomi delle pagine wiki. Esempio: wikipedia
parametri: elenco opzionale di parametri che si possono passare al link. Esempio: rel="__blank" (apri in una nuova finestra)

Tabelle

2.0 Tables

È possibile creare facilmente del testo in forma tabellare. Con la Sintassi XWiki 2.0 sono supportati anche parametri per la tabella, le righe o le celle.

Caratteristica

Sintassi XWiki 2.0

Risultato

Tabella Standard

|=Titolo 1|=Titolo 2 |Parola 1|Parola 2
}}}

!=Titolo 1!=Titolo 2
!!Parola 1!!Parola 2

Titolo 1	Titolo 2
Parola 1	Parola 2

Tabella con Parametri

(% style="background-color:red;text-align:center" %)
|=Titolo 1|=(% style="background-color:yellow" %)Titolo 2
|Parola 1|Parola 2

Titolo 1	Titolo 2
Parola 1	Parola 2

Tabella filtrabile ordinabile

{{velocity}}
$xwiki.ssfx.use("js/xwiki/table/table.css")
$xwiki.jsfx.use("js/xwiki/table/tablefilterNsort.js", true)
{{/velocity}}

(% class="grid sortable filterable doOddEven" id="tableid" %)
(% class="sortHeader" %)|=Titolo 1|=Titolo 2
|Cella 11|Cella 12
|Cella 21|Cella 22

Per caratteristiche avanzate vedere la Livetable Macro.

Titolo 1

Titolo 2

Cella 11

Cella 12

Cella 21

Cella 22

Immagini

2.0 Images

Caratteristica	Sintassi XWiki 2.0	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

Specifiche per le Immagini in Sintassi XWiki 2.0

La parte tra ( ) è richiesta, mentre le parti tra { } sono opzionali.

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 http://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.
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.