Loading…
 None
String updated in the repository |
|
|
None
Source string changed |
|
Loading…
|
None
String updated in the repository |
|
|
None
Source string changed |
|
== Introduction ==
{{comment}}please do not translate the sub headlines{{/comment}}
=== 1.0 Introduction ===
The XWiki Syntax 1.0 was the first attempt to implement a Wiki-style Syntax in XWiki. It had some limitations and some formatting can only be achieved by inserting raw HTML. We recommend using the newer syntaxes; XWiki Syntax 1.0 is only supported for backwards compatibility.
In addition to the XWiki-specific syntaxes we've also changed our underlying rendering engine in XWiki 1.7 (was Radeox previously) in favor of our own engine which is superset wrapper around [[Wikimodel>>https://code.google.com/p/wikimodel/]] and [[Doxia>>https://maven.apache.org/doxia/]] (and possibly others in the future). This has allowed us to provide other syntaxes in the wiki: {{velocity}}[[MediaWiki, Confluence, JSPWiki, Creole, TWiki and more>>||queryString="syntax=1.0§ion=OtherSyntaxes#if($request.xpage)&xpage=$escapetool.url($request.xpage)#end"]]{{/velocity}}.
=== 2.0 Introduction ===
Starting with XWiki 1.7 we've introduced a new wiki syntax. We've named the old syntax the //XWiki Syntax 1.0// and the new syntax was logically called the //XWiki Syntax 2.0//. The main reasons for introducing the new syntax were:
* Fix the limitations and ambiguities of the XWiki 1.0 syntax (which was inspired by both Radeox - the underlying rendering engine - and TWiki).
** Not optimal symbols. For example the symbol for bold was single stars. This was causing trouble when users were entering text containing stars since that text was mistakenly considered to be bold when it wasn't. Hence we've rationalized the syntax by using at least double characters everywhere.
** Ambiguities. For example there was an ambiguity between a bold item starting a line and a bullet list. Resolving the ambiguities was required in order to rewrite the WYSIWYG editor so that it could be deterministic.
* Be closer to the [[Creole 1.0 syntax>>https://www.wikicreole.org/]] which is becoming a standard for wiki syntax. In addition the Creole community has taken the time to analyze all the existing wiki syntaxes before deciding on symbols. The choices made are thus very good.
In addition to these XWiki-specific syntaxes we've also changed our underlying rendering engine (was Radeox previously) in favor of our own engine which is superset wrapper around [[Wikimodel>>https://code.google.com/p/wikimodel/]] and [[Doxia>>https://maven.apache.org/doxia/]] (and possibly others in the future). This has allowed us to provide other syntaxes in the wiki: {{velocity}}[[MediaWiki, Confluence, JSPWiki, Creole, TWiki and more>>||queryString="syntax=2.0§ion=OtherSyntaxes#if($request.xpage)&xpage=$escapetool.url($request.xpage)#end"]]{{/velocity}}.
=== 2.1 Introduction ===
The XWiki Syntax 2.0 has proven to be quite useful and robust in general; however since its introduction a few shortcomings have been found. The corresponding improvements have been consolidated in XWiki Syntax 2.1. Some new features of this syntax are:
* Homogenize the link and image syntax for better clarity, consistency and extensibility.
* Added ability to display icons, to embed images via the Data URI scheme, to link to files using the UNC notation and to link to relative URLs.
{{info}}Since XWiki Syntax 2.1 is based on XWiki Syntax 2.0 all syntax from XWiki Syntax 2.0 is valid unless the 2.1 specifications suggest differently.{{/info}}
== Preliminare ==
{{comment}}please do not translate the sub headlines{{/comment}}
=== 1.0 Introduction ===
A partire dalla versione 1.7 di XWiki Enterprise abbiamo introdotto una nuova sintassi di xwiki. La vecchia sintassi era stata chiamata //Sintassi XWiki 1.0// e la nuova sintassi fu chiamata conseguentemente //Sintassi XWiki 2.0//. I motivi principali per l'introduzione di una nuova sintassi sono stati i seguenti:
* Superare i limiti e le ambiguità della sintassi XWiki 1.0 (che fu ispirata sia da Radeox - il motore di rendering sottostante- e da TWiki).
** Simboli non ottimali. Per esempio il simbolo per il grassetto era un asterisco singolo. Ciò causava problemi quando gli utenti inserivano del testo che conteneva degli asterischi, dal momento che il testo seguente veniva considerato erroneamente in grassetto, mentre non lo era affatto. Per cui abbiamo razionalizzato la sintassi usando almeno caratteri doppi ovunque possibile.
** Ambiguità. Per esempio c'era ambiguità tra una voce in grassetto all'inizio di una riga ed un elenco puntato. Era necessario risolvere le ambiguità per poter riscrivere l'editor WYSIWYG in modo che fosse deterministico.
* Per essere più vicini alla [[Sintassi Creole 1.0>>http://www.wikicreole.org/]] che sta diventando lo standard delle sintasssi per i wiki. Inoltre la comunità di Creole ha speso del tempo per analizzare tutte le sintassi dei wiki esistenti prima di decidere i simboli da usare. Per cui le scelte fatte sono molto buone.
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>>http://code.google.com/p/wikimodel/]] e [[Doxia>>http://maven.apache.org/doxia/]] (e si spera altri in futuro). Questo ci ha consentito di poter usare anche altre sintassi nel wiki: {{velocity}}[[MediaWiki, Confluence, JSPWiki, Creole, TWiki e altre>>||queryString="syntax=1.0§ion=OtherSyntaxes#if($request.xpage)&xpage=$escapetool.url($request.xpage)#end"]]{{/velocity}}.
=== 2.0 Introduction ===
A partire dalla versione 1.7 di XWiki Enterprise abbiamo introdotto una nuova sintassi di xwiki. La vecchia sintassi era stata chiamata //Sintassi XWiki 1.0// e la nuova sintassi fu chiamata conseguentemente //Sintassi XWiki 2.0//. I motivi principali per l'introduzione di una nuova sintassi sono stati i seguenti:
* Superare i limiti e le ambiguità della sintassi XWiki 1.0 (che fu ispirata sia da Radeox - il motore di rendering sottostante- e da TWiki).
** Simboli non ottimali. Per esempio il simbolo per il grassetto era un asterisco singolo. Ciò causava problemi quando gli utenti inserivano del testo che conteneva degli asterischi, dal momento che il testo seguente veniva considerato erroneamente in grassetto, mentre non lo era affatto. Per cui abbiamo razionalizzato la sintassi usando almeno caratteri doppi ovunque possibile.
** Ambiguità. Per esempio c'era ambiguità tra una voce in grassetto all'inizio di una riga ed un elenco puntato. Era necessario risolvere le ambiguità per poter riscrivere l'editor WYSIWYG in modo che fosse deterministico.
* Per essere più vicini alla [[Sintassi Creole 1.0>>http://www.wikicreole.org/]] che sta diventando lo standard delle sintasssi per i wiki. Inoltre la comunità di Creole ha speso del tempo per analizzare tutte le sintassi dei wiki esistenti prima di decidere i simboli da usare. Per cui le scelte fatte sono molto buone.
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>>http://code.google.com/p/wikimodel/]] e [[Doxia>>http://maven.apache.org/doxia/]] (e si spera altri in futuro). Questo ci ha consentito di poter usare anche altre sintassi nel wiki: {{velocity}}[[MediaWiki, Confluence, JSPWiki, Creole, TWiki e altre>>||queryString="syntax=2.0§ion=OtherSyntaxes#if($request.xpage)&xpage=$escapetool.url($request.xpage)#end"]]{{/velocity}}.
=== 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.
{{info}}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.{{/info}}
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>>http://code.google.com/p/wikimodel/]] e [[Doxia>>http://maven.apache.org/doxia/]] (e si spera altri in futuro). Questo ci ha consentito di poter usare anche altre sintassi nel wiki: {{velocity}}[[MediaWiki, Confluence, JSPWiki, Creole, TWiki e altre>>||queryString="syntax=2.1§ion=OtherSyntaxes#if($request.xpage)&xpage=$escapetool.url($request.xpage)#end"]]{{/velocity}}.