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}}
== Introduction ==
{{comment}}please do not translate the sub headlines{{/comment}}
=== 1.0 Introduction ===
À partir de XWiki Enterprise 1.7, nous avons introduit une nouvelle syntaxe wiki. Alors, nous dénommons la syntaxe précédente la //Syntaxe XWiki v1.0//, tandis que la nouvelle syntaxe est logiquement appelée la //Syntaxe XWiki v2.0//. Les raisons principales pour l'introduction de la nouvelle syntaxe ont été les suivantes:
En plus de ces 2 syntaxes XWiki, nous avons aussi changé notre moteur de rendu sous-jacent (précédemment c'était Radeox) en faveur de notre propre moteur, qui est un sur-ensemble emballé autour de [[Wikimodel>>http://code.google.com/p/wikimodel/]] et [[Doxia>>http://maven.apache.org/doxia/]] (et éventuellement d'autres dans le futur). Cela nous a permis de fournir d'autres syntaxes dans le wiki: {{velocity}}[[MediaWiki, Confluence, JSPWiki, Creole, TWiki et plus>>||queryString="syntax=1.0§ion=OtherSyntaxes#if($request.xpage)&xpage=$escapetool.url($request.xpage)#end"]]{{/velocity}}.
=== 2.0 Introduction ===
À partir de XWiki Enterprise 1.7, nous avons introduit une nouvelle syntaxe wiki. Alors, nous dénommons la syntaxe précédente la //Syntaxe XWiki v1.0//, tandis que la nouvelle syntaxe est logiquement appelée la //Syntaxe XWiki v2.0//. Les raisons principales pour l'introduction de la nouvelle syntaxe ont été les suivantes:
* Corriger les limitations et les ambiguïtés de la syntaxe XWiki 1.0.
** Les symboles sous-optimales. Par exemple, le symbole pour le texte gras était représenté par des astérisques simples. Cela causait des problèmes lorsque les utilisateurs renseignaient du texte contenant des astérisques, parce que celui-ci était considéré comme gras lorsqu'il ne l'était pas. C'est pourquoi nous avons rationalisé la syntaxe en utilisant partout des caractères doubles.
** Ambiguïtés. Par exemple il y avait une ambiguïté entre un élément de gras placé au début d'une ligne et une liste à puces. La résolution du problème des ambiguïtés était nécessaire pour réécrire l'éditeur WYSIWYG afin qu'il puisse être déterministe.
* Être plus près de la syntaxe [[Creole 1.0>>http://www.wikicreole.org/]] qui devient une norme pour la syntaxe wiki. En outre, la communauté Creole a pris son temps d'analyser toutes les syntaxes wiki existantes avant de décider sur les symboles.
En plus de ces 2 syntaxes XWiki, nous avons aussi changé notre moteur de rendu sous-jacent (précédemment c'était Radeox) en faveur de notre propre moteur, qui est un sur-ensemble emballé autour de [[Wikimodel>>http://code.google.com/p/wikimodel/]] et [[Doxia>>http://maven.apache.org/doxia/]] (et éventuellement d'autres dans le futur). Cela nous a permis de fournir d'autres syntaxes dans le wiki: {{velocity}}[[MediaWiki, Confluence, JSPWiki, Creole, TWiki et plus>>||queryString="syntax=2.0§ion=OtherSyntaxes#if($request.xpage)&xpage=$escapetool.url($request.xpage)#end"]]{{/velocity}}
=== 2.1 Introduction ===
Depuis l'introduction de la syntaxe XWiki 2.0, quelques lacunes de cette syntaxe ont été trouvées. Pour y remédier, la syntaxe XWiki 2.1, actuellement //expérimentale//, a été ajoutée dans XWiki Enterprise version 3.0. Cette nouvelle syntaxe a été notamment développée pour les raisons suivantes:
* Homogénéiser la syntaxe des liens et des images pour plus de cohérence et de clarté, ainsi que la possibilité de l'étendre ultérieurement.
* Ajouter la possibilité d'afficher des icônes, d'utiliser la notation UNC pour ajouter des liens, et de créer des liens vers des adresses relatives.
{{info}} La syntaxe XWiki 2.1 étant basée sur la syntaxe XWiki 2.0, toute la syntaxe XWiki 2.0 reste valable sauf si les caractéristiques de la syntaxe XWiki 2.1 précisent un changement. {{/info}}
En plus de ces 2 syntaxes XWiki, nous avons aussi changé notre moteur de rendu sous-jacent (précédemment c'était Radeox) en faveur de notre propre moteur, qui est un sur-ensemble emballé autour de [[Wikimodel>>http://code.google.com/p/wikimodel/]] et [[Doxia>>http://maven.apache.org/doxia/]] (et éventuellement d'autres dans le futur). Cela nous a permis de fournir d'autres syntaxes dans le wiki: {{velocity}}[[MediaWiki, Confluence, JSPWiki, Creole, TWiki et plus>>||queryString="syntax=2.1§ion=OtherSyntaxes#if($request.xpage)&xpage=$escapetool.url($request.xpage)#end"]]{{/velocity}}