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}}
== Inledning ==
{{comment}}please do not translate the sub headlines{{/comment}}
=== 1.0 Introduction ===
Med början på XWiki enterprise version 1.7 och senare har en ny wikisyntax, kallad //XWiki syntax v2.0//, introducerats som efterföljare till //XWiki syntax v1.0//. De huvudsakliga anledningarna för den nya syntaxen är:
* Fixa begränsningarna och tvetydigheterna som finns i XWiki 1.0 syntaxen (som byggde både på Radeox - den underliggande renderingsmotorn - och TWiki).
** Symbolvalen var inte bra. Exempelvis användes en asterisk för att ange fetstil. Detta orsakade problem då användare matade in text som innehöll asterisker eftersom texten felaktigt antogs vara fetstil. Således används åtminstone dubbla symboler överallt i wikisyntaxen.
** Tvetydigheter fanns exempelvis då en rad inleddes med en asterisk. Var det då fetstil eller en punktlista? Detta var nödvändigt att lösa för att möjliggöra en deterministisk WYSIWYG-editor.
* För att närma sig [[Creole 1.0 syntaxen>>http://www.wikicreole.org/]] vilken håller på att bli standard för wikisyntax. Sammanslutningen bakom Creole har dessutom noggrant analyserat alla existerande wikisyntaxer innan de valt symboler. Symbolvalen är därför väldigt bra.
Utöver syntaxändringarna har vi också bytt ut den underliggande renderingsmotorn (vilken tidigare var Radeox) till förmån för vår egen motor som bygger på [[Wikimodel>>http://code.google.com/p/wikimodel/]] och [[Doxia>>http://maven.apache.org/doxia/]] (och möjligen andra i framtiden). Detta låter oss tillhandahålla andra syntaxer i wikin: {{velocity}}[[MediaWiki, Confluence, JSPWiki, Creole, TWiki m.fl.>>||queryString="syntax=1.0§ion=OtherSyntaxes#if($request.xpage)&xpage=$escapetool.url($request.xpage)#end"]]{{/velocity}}
=== 2.0 Introduction ===
Med början på XWiki enterprise version 1.7 och senare har en ny wikisyntax, kallad //XWiki syntax v2.0//, introducerats som efterföljare till //XWiki syntax v1.0//. De huvudsakliga anledningarna för den nya syntaxen är:
* Fixa begränsningarna och tvetydigheterna som finns i XWiki 1.0 syntaxen (som byggde både på Radeox - den underliggande renderingsmotorn - och TWiki).
** Symbolvalen var inte bra. Exempelvis användes en asterisk för att ange fetstil. Detta orsakade problem då användare matade in text som innehöll asterisker eftersom texten felaktigt antogs vara fetstil. Således används åtminstone dubbla symboler överallt i wikisyntaxen.
** Tvetydigheter fanns exempelvis då en rad inleddes med en asterisk. Var det då fetstil eller en punktlista? Detta var nödvändigt att lösa för att möjliggöra en deterministisk WYSIWYG-editor.
* För att närma sig [[Creole 1.0 syntaxen>>http://www.wikicreole.org/]] vilken håller på att bli standard för wikisyntax. Sammanslutningen bakom Creole har dessutom noggrant analyserat alla existerande wikisyntaxer innan de valt symboler. Symbolvalen är därför väldigt bra.
Utöver syntaxändringarna har vi också bytt ut den underliggande renderingsmotorn (vilken tidigare var Radeox) till förmån för vår egen motor som bygger på [[Wikimodel>>http://code.google.com/p/wikimodel/]] och [[Doxia>>http://maven.apache.org/doxia/]] (och möjligen andra i framtiden). Detta låter oss tillhandahålla andra syntaxer i wikin: {{velocity}}[[MediaWiki, Confluence, JSPWiki, Creole, TWiki m.fl.>>||queryString="syntax=2.0§ion=OtherSyntaxes#if($request.xpage)&xpage=$escapetool.url($request.xpage)#end"]]{{/velocity}}
=== 2.1 Introduction ===
Sedan introduktionen av XWiki syntax 2.0 har några begränsningar upptäckts. För att åtgärda dessa har den //experimentella// syntaxen XWiki syntax 2.1 introducerats i XWiki Enterprise version 3.0. Anledningarna att denna nya syntax utvecklats är:
* Harmonisera länk- och bild-syntaxerna för tydlighetens och konsekvensens skull och för att förbättra påbyggnadsmöjligheterna.
* Möjligheten att visa ikoner, att länka till filer med UNC-notation och att länka till relativa URL:er.
{{info}}Eftersom XWiki syntax 2.1 bygger på XWiki syntax 2.0 gäller all syntax från XWiki syntax 2.0 om inte annat anges i specifikationen för 2.1.{{/info}}
Utöver syntaxändringarna har vi också bytt ut den underliggande renderingsmotorn (vilken tidigare var Radeox) till förmån för vår egen motor som bygger på [[Wikimodel>>http://code.google.com/p/wikimodel/]] och [[Doxia>>http://maven.apache.org/doxia/]] (och möjligen andra i framtiden). Detta låter oss tillhandahålla andra syntaxer i wikin: {{velocity}}[[MediaWiki, Confluence, JSPWiki, Creole, TWiki m.fl.>>||queryString="syntax=2.1§ion=OtherSyntaxes#if($request.xpage)&xpage=$escapetool.url($request.xpage)#end"]]{{/velocity}}