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: Generale

  
XWiki Syntax 2.1 » Generale
XWiki Syntax 2.1: Generale
•	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

Preliminare
2.1 Introduction
Dopo l'introduzione della sintassi XWiki 2.0 abbiamo scoperto alcuni difetti di questa sintassi. Per risolverli è stata introdotta, per il momento in via sperimentale, la sintassi XWiki 2.1 a partire dalla versione 3.0 di XWiki Enterprise. Ecco alcuni dei motivi per l'introduzione di questa nuova sintassi:
•	Omogeneizzare la sintassi per i link e per le immagini, così da ottenere maggiore chiarezza, consistenza ed estendibilità.
•	Aggiungere la possibilità di mostrare icone, di fare collegamenti a file usando la notazione UNC e fare link a URL relativi.
Dal momento che la sintassi XWiki 2.1 si basa sulla sintassi XWiki 2.0, tutti i costrutti con sintassi XWiki 2.0 rimangono validi a meno che le specifiche della sintassi XWiki 2.1 indichino diversamente.
Oltre a queste due sintassi specifiche di XWiki abbiamo modificato anche il motore di rendering sottostante con XWiki Enterprise versione 1.7 (precedentemente era Radeox) in favore di un nostro motore che è un superset wrapper attorno a Wikimodel e Doxia (e si spera altri in futuro). Questo ci ha consentito di poter usare anche altre sintassi nel wiki: MediaWiki, Confluence, JSPWiki, Creole, TWiki e altre.
Considerazioni Generali
2.0 General Remarks
La sintassi XWiki 2.0 corregge alcuni errori o ambiguità che gli utenti potevano inserire come mostrato negli esempi della tabella seguente.
Descrizione	Esempio di sintassi non valida o ambigua	Risolto con Sintassi XWiki 2.0	
Stili di testo non chiusi	**grassetto	**grassetto**	
Due elementi isolati non separati da 2 nuove righe	| cella tabella
* voce elenco	| cella tabella

* voce elenco	
Due elementi isolati non separati da 2 nuove righe	paragrafo
----
paragrafo	paragrafo

----

paragrafo	
Nuova riga ignorata all'inizio del documento	<nuova riga all'inizio del documento>
paragrafo	paragrafo	
Sintassi dei titoli non chiusa	=== titolo	=== titolo ===	
Altre sintassi
1.0 Other Syntaxes
A partire da XWiki Enterprise 1.6 sono implementate anche queste altre sintassi:
•	JSPWiki
•	MediaWiki
•	Confluence
•	TWiki
•	Creole 1.0
•	XHTML 1.0
L'implementazione di queste sintassi non è stata ancora completata. Per esempio il supporto ai link non funziona ancora perfettamente. Dobbiamo anche definire se estendere le sintassi originali per supportare le caratteristiche specifiche di XWiki come la possibilità di fare un link ad un altro sub-wiki.