XWiki Syntax Guide

XWiki Syntax 2.1: Generale

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:

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.