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.