XWiki Syntax Hilfe
XWiki Syntax 2.0 » Allgemeines
XWiki Syntax 2.0: Allgemeines
Einführung
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 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 und Doxia (und möglicherweise weiteren in der Zukunft) bildet. Dies hat es uns erlaubt weitere Syntaxen im Wiki anzubieten: MediaWiki, Confluence, JSPWiki, Creole, TWiki und mehr.
Bemerkungen
2.0 General Remarks
XWiki Syntax 2.0 korrigiert einige Fehler oder mehrdeutige Syntax, die vom Nutzer eingegeben wird, wie in den Beispielen in der Tabelle unterhalb gezeigt.
| Beschreibung | Beispiel für ungültige oder mehrdeutige Syntax | Korrigierte Syntax 2.0 |
|---|---|---|
| Nicht geschlossener Textstil | **fett | **fett** |
| Zwei unabhängige Elemente sind nicht durch 2 neue Zeilen getrennt | | Tabellenzelle * Listenelement | | Tabellenzelle * Listenelement |
| Zwei unabhängige Elemente sind nicht durch 2 neue Zeilen getrennt | Absatz ---- Absatz | Absatz ---- Absatz |
| Ignorierte neue Zeilen am Anfang von Dokument | <neue Zeile am Anfang des Dokuments> Absatz | Absatz |
| Nicht geschlossene Überschriftensyntax | === Überschrift | === Überschrift === |
Weitere Syntaxen
1.0 Other Syntaxes
Andere Syntaxen sind auch verfügbar.