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}}
== Introducción ==
{{comment}}please do not translate the sub headlines{{/comment}}
=== 1.0 Introduction ===
La sintaxis XWiki 1.0 fue el primer intento de implementar una sintaxis estilo Wiki. Tiene algunas limitaciones y hay algunos formatos que solo se pueden llevar a cabo insertando HTML directamente. Recomendamos utilizar las sintaxis más modernas; solo se soporta la sintaxis XWiki 1.0 por compatibilidad.
Además de las sintaxis específicas de XWiki también hemos cambiado el motor de renderizado interno en XWiki Enterprise versión 1.7 (anteriormente era Radeox) por nuestro motor propio que es un superconjunto que envuelve a [[Wikimodel>>http://code.google.com/p/wikimodel/]] y [[Doxia>>http://maven.apache.org/doxia/]] (y otros posiblemente en el futuro). Esto nos ha permitido proporcionar otras sintaxis en la wiki: {{velocity}}[[MediaWiki, Confluence, JSPWiki, Creole, TWiki y más>>||queryString="syntax=1.0§ion=OtherSyntaxes#if($request.xpage)&xpage=$escapetool.url($request.xpage)#end"]]{{/velocity}}.
=== 2.0 Introduction ===
Con la versión 1.7 de XWiki Enterprise, hemos introducido una sintaxis wiki nueva. Hemos llamado a la sintaxis antigua //Sintaxis XWiki 1.0// y, lógicamente, la sintaxis nueva se llama //Sintaxis XWiki 2.0//. Las razones principales para introducir la sintaxis nueva han sido:
* Solucionar las limitaciones y ambigüedades de la Sintaxis XWiki 1.0 (inspirada en Radeox, el motor de renderizado interno, y TWiki).
** Sin símbolos óptimos. Por ejemplo, el símbolo de la negrita eran asteriscos sencillos. Esto creaba problemas cuando los usuarios tecleaban texto que contenía asteriscos, ya que ese texto se consideraba en negrita por error cuando no lo estaba. Por lo tanto, hemos racionalizado la sintaxis utilizando al menos caracteres dobles en todas partes.
** Ambigüedades. Por ejemplo, había una ambigüedad entre un elemento en negrita que comenzaba una línea y una lista de viñetas. Se requería resolver las ambigüedades para reescribir el editor WYSIWYG de modo que pudiera ser determinista.
* Estar más cerca de la [[Sintaxis Creole 1.0 >> http://www.wikicreole.org/]] que se está convirtiendo en un estándar para la sintaxis wiki. Además, la comunidad Creole ha dedicado tiempo a analizar todas las sintaxis wiki existentes antes de decidir sobre los símbolos. Las elecciones hechas son, por lo tanto, muy buenas.
Además de las sintaxis específicas de XWiki también hemos cambiado el motor de renderizado interno en XWiki Enterprise versión 1.7 (anteriormente era Radeox) por nuestro motor propio que es un superconjunto que envuelve a [[Wikimodel>>http://code.google.com/p/wikimodel/]] y [[Doxia>>http://maven.apache.org/doxia/]] (y otros posiblemente en el futuro). Esto nos ha permitido proporcionar otras sintaxis en la wiki: {{velocity}}[[MediaWiki, Confluence, JSPWiki, Creole, TWiki y más>>||queryString="syntax=2.0§ion=OtherSyntaxes#if($request.xpage)&xpage=$escapetool.url($request.xpage)#end"]]{{/velocity}}.
=== 2.1 Introduction ===
La Sintaxis XWiki 2.0 ha demostrado ser bastante útil y robusta en general; sin embargo, desde su introducción se han encontrado algunas deficiencias. Las mejoras correspondientes se han consolidado en la Sintaxis XWiki 2.1. Algunas características nuevas de esta sintaxis son:
* Homogenización de la sintaxis de enlaces e imágenes para una mayor claridad, consistencia y extensibilidad.
* Se ha añadido la capacidad de mostrar iconos, incrustar imágenes a través del esquema URI Data, vincular archivos usando la notación UNC y vincular a URLs relativas.
{{info}}Como la Sintaxis XWiki 2.1 se basa en la Sintaxis XWiki 2.0, toda la Sintaxis XWiki 2.0 es válida a menos que las especificaciones de la 2.1 indiquen lo contrario.{{/info}}
Además de las sintaxis específicas de XWiki también hemos cambiado el motor de renderizado interno en XWiki Enterprise versión 1.7 (anteriormente era Radeox) por nuestro motor propio que es un superconjunto que envuelve a [[Wikimodel>>http://code.google.com/p/wikimodel/]] y [[Doxia>>http://maven.apache.org/doxia/]] (y otros posiblemente en el futuro). Esto nos ha permitido proporcionar otras sintaxis en la wiki: {{velocity}}[[MediaWiki, Confluence, JSPWiki, Creole, TWiki y más>>||queryString="syntax=2.1§ion=OtherSyntaxes#if($request.xpage)&xpage=$escapetool.url($request.xpage)#end"]]{{/velocity}}.