Loading…
None
String updated in the repository |
|
Simpel
Translation changed |
|
Simpel
Contributor joined |
Contributor joined
2 years ago
|
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}}
== Einführung ==
{{comment}}please do not translate the sub headlines{{/comment}}
=== 1.0 Introduction ===
Die XWiki Syntax 1.0 war der erste Ansatz, eine Syntax im Wiki-Stil in XWiki zu implementieren. Diese hat einige Limitierungen, und manche Formatierungen können nur durch direkten Einsatz von HTML erzeugt werden. Daher empfehlen wir die Verwendung der neueren Syntaxen. XWiki Syntax 1.0 wird nur noch aus Gründen der Rückwärtskompatibilität angeboten.
Zusätzlich zu den XWiki-spezifischen Syntaxen haben wir auch unsere zugrunde liegende Rendering-Engine (war vormals Radeox) durch unsere eigene Engine ausgetauscht, welche eine Obermengenhülle um [[Wikimodel>>http://code.google.com/p/wikimodel/]] und [[Doxia>>http://maven.apache.org/doxia/]] (und möglicherweise weiteren in der Zukunft) bildet. Dies hat es uns erlaubt weitere Syntaxen im Wiki anzubieten: {{velocity}}[[MediaWiki, Confluence, JSPWiki, Creole, TWiki und mehr>>||queryString="syntax=1.0§ion=OtherSyntaxes#if($request.xpage)&xpage=$escapetool.url($request.xpage)#end"]]{{/velocity}}.
=== 2.0 Introduction ===
Beginnend mit XWiki Enterprise Version 1.7 und darüber haben wir eine neue Wiki Syntax eingeführt. Daher haben wir die alte Syntax die //XWiki Syntax 1.0// benannt und die neue Syntax wird sinnigerweise //XWiki Syntax 2.0// genannt. Die Hauptgründe für die Einführung der neuen Syntax waren:
* Die Einschränkungen und Mehrdeutigkeiten der XWiki 1.0 Syntax (welche sowohl durch Radeox - der zugrunde liegenden Rendering-Engine - und TWiki inspiriert wurde) beheben.
** Nicht optimale Symbole. Zum Beispiel war das Symbol für Fettdruck ein einzelner Stern. Dies hat Probleme verursacht, wenn der Nutzer Texte eingab, die Sterne beinhalteten, da dieser Text fälschlicherweise als fett angenommen wurde, auch wenn er das nicht war. Daher haben wir die Syntax robuster gemacht, indem überall mindestens doppelte Zeichen verwendet werden.
** Mehrdeutigkeiten. Zum Beispiel gab es eine Mehrdeutigkeit zwischen einem fettengedruckten Element, dass die Zeile begann, und einer Aufzählungsliste. Diese Mehrdeutigkeiten mussten beseitigt werden, damit u.a. der WYSIWYG Editor beiden Fälle unterscheiden kann.
* Um näher an der [[Creole 1.0 Syntax>>http://www.wikicreole.org/]] zu sein, welche ein Standard für Wiki Syntax wird. Zusätzlich hat die Creole Gemeinde sich die Zeit genommen, um alle existierenden Wiki Syntaxen zu analysieren, bevor sie sich für Symbole entschieden haben. Diese Entscheidungen sind daher sehr gut.
Zusätzlich zu den XWiki-spezifischen Syntaxen haben wir auch unsere zugrunde liegende Rendering-Engine (war vormals Radeox) durch unsere eigene Engine ausgetauscht, welche eine Obermengen um [[Wikimodel>>http://code.google.com/p/wikimodel/]] und [[Doxia>>http://maven.apache.org/doxia/]] (und möglicherweise weiteren in der Zukunft) bildet. Dies hat es uns erlaubt weitere Syntaxen im Wiki anzubieten: {{velocity}}[[MediaWiki, Confluence, JSPWiki, Creole, TWiki und mehr>>||queryString="syntax=2.0§ion=OtherSyntaxes#if($request.xpage)&xpage=$escapetool.url($request.xpage)#end"]]{{/velocity}}.
=== 2.1 Introduction ===
Die XWiki Syntax 2.1 ist die aktuell empfohlene Wiki Syntax. Gegenüber der XWiki Syntax 2.0 wurden einige Verbesserungen eingeführt. Einige Gründe für die Entwicklung dieser neuen Syntax sind:
* Die Link- und Bildsyntax wurde für bessere Klarheit, Konsistenz und Erweiterbarkeit vereinheitlicht.
* Möglichkeit zum Anzeigen von Piktogrammen, zum Einbetten von Bildern mittels 'data:'-URLs sowie zum Verlinken von Dateien mittels der UNC Notation und dem Verlinken zu relativen URLs wurden hinzugefügt.
{{info}}
Da die XWiki Syntax 2.1 auf der XWiki Syntax 2.0 basiert, bleibt die gesamte XWiki Syntax 2.0 gültig, solange die 2.1 Spezifikation nichts anderes besagt.
{{/info}}