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.

Weitere Syntaxen

1.0 Other Syntaxes

Andere Syntaxen sind auch verfügbar.

Bearbeiten

Absatz

2.0 Paragraphs

Absätze sind Textelemente, die durch zwei oder mehr neue Zeilen getrennt sind.

Überschriften

2.0 Headings

= Ebene 1 = 
== Ebene 2 ==
=== Ebene 3 ===
==== Ebene 4 ====
===== Ebene 5 =====
====== Ebene 6 ======

Textformatierung

2.0 Text Formatting

Horizontale Linie

2.0 Horizontal Line

(% style="border-color:blue" %)
----

Listen

2.0 Lists

* Element 1
** Element 2
*** Element 3
* Element 4

1. Element 1
11. Element 2
111. Element 3
1. Element 4

1. Element 1
1*. Element 2
1*. Element 3
1. Element 4

(% style="list-style-type: square" %)
* Element 1
* Element 2

(% style="list-style-type: disc" %)
* Element 1
* Element 2

(% style="list-style-type: lower-alpha" %)
* Element 1
* Element 2

(% style="list-style-type: upper-alpha" %)
* Element 1
* Element 2

(% style="list-style-type: lower-roman" %)
* Element 1
* Element 2

(% style="list-style-type: upper-roman" %)
* Element 1
* Element 2

(% style="list-style-type: lower-greek" %)
* Element 1
* Element 2

(% style="list-style-type: upper-greek" %)
* Element 1
* Element 2

(% style="list-style-type: hiragana" %)
* Element 1
* Element 2

(% style="list-style-type: hiragana-iroha" %)
* Element 1
* Element 2

(% style="list-style-type: katakana" %)
* Element 1
* Element 2

(% style="list-style-type: katakana-iroha" %)
* Element 1
* Element 2

(% style="list-style-type: armenian" %)
* Element 1
* Element 2

(% style="list-style-type: hebrew" %)
* Element 1
* Element 2

(% style="list-style-type: georgian" %)
* Element 1
* Element 2

(% style="list-style-type: cjk-ideographic" %)
* Element 1
* Element 2

Definitionslisten

2.0 Definition Lists

; Begriff
: Definition

; Begriff 1
: Definition 1
:; Begriff 2
:: Definition 2

(% style="color:blue" %)
; Begriff
: Definition

Neue Zeile/Zeilenumbruch

2.0 New Line Line Breaks

Eine neue Zeile ist ein Absatzende. Ein Zeilenumbruch ist eine erzwungene neue Zeile, welche an jeder Stelle im Text auftreten kann.

Links

2.0 Links

Funktion	XWiki Syntax 2.0	Ergebnis
Link zu Seite im aktuellen Bereich	[[WebHome]]	XWiki
Link mit Linktext	[[Linktext>>WebHome]] XWiki Syntax innerhalb des Linktextes wird unterstützt.	Linktext
Link mit XWiki Syntax im Linktext	[[**fetter Linktext**>>WebHome]]	fetter Linktext
Link zu Seite im angegebenen Bereich	[[Main.WebHome]]	Main
Link zu einem Unterwiki	[[subwiki:Main.WebHome]]	Main
Link der in neuem Fenster öffnet	[[Linktext>>WebHome||rel="__blank"]]	Linktext
Link zu einer URL direkt im Text	Dies ist eine URL: https://xwiki.org	Dies ist eine URL: https://xwiki.org
Link zu einer URL	[[https://xwiki.org]]	https://xwiki.org
Link zu einer URL mit Linktext	[[XWiki>>https://xwiki.org]]	XWiki
Link zu einer E-Mail-Adresse	[[john@smith.net>>mailto:john@smith.net]]	john@smith.net
Bild-Link	[[image:Bereich2.Seite2@Bild.png>>Bereich1.Seite1]]
Bild-Link mit Bildparametern	[[[[image:Bereich2.Seite2@Bild.png||width="26" height="26"]]>>Bereich1.Seite1]]
Link zu einem Anhang auf der aktuellen Seite	[[Text>>attach:img.png]]	Text
Link zu einem Anhang auf einer anderen Seite	[[Text>>attach:Bereich.Seite@img.png]]	Text
Link zu einem Anker auf einer Seite	[[Text>>Bereich.Seite#anchor]]	Text
Link zu einer Überschrift auf einer Seite	[[Text>>Bereich.Seite#HMyheading]]	Text

XWiki Syntax 2.0 Linkspezifikation

Das vollständige Format eines Links ist [Linktext>>] (Ressource) [@interWikiAlias] [||Parameter]

• Linktext: Eine optionale Zeichenkette, welche dem Nutzer beim Rendern als Linkname gezeigt wird. Der Linktext kann XWiki Syntax enthalten. Wenn kein Linktext angegeben ist, wird ein Standartext generiert. Das Erstellungsmuster kann verändert werden, siehe Admin Guide. Beispiel: Meine Seite
• Ressource: Die vollständige Linkreferenz in folgender Syntax: (Referenz) [?queryString] [#Anker]
  • Referenz: Die Linkreferenz in einer der folgenden Formen:
    • URL: Eine URL in der Form Protokoll://Pfad. Beispiele: http://xwiki.org, https://svn.xwiki.org/
    • Wikiseitenname Referenz in der Form [[wikiName:] Bereich.] (Seite). Beispiele: WebHome, Main.WebHome, mywiki:Main.WebHome
      • wikiName: Eine optionale Zeichenkette, die den Namen des virtuellen Wikis enthält. Der Link wird auf eine Seite in diesem virtuellen Wiki zeigen. Beispiel: mywiki
      • Bereich: Ein optionaler Bereichsname. Wenn kein Bereich spezifiziert wird, wird der aktuelle Bereich verwendet. Beispiel: Main
      • Seite: Eine erforderliche Zeichenkette, die den Namen der verknüpften Wikiseite enthält. Beispiel: WebHome
    • Anhang Referenz in der Form attach: [wikiSeitenName @] (anhangsName) (#Anker ist nicht zulässig). Beispiele: attach:img.png, attach:mywiki:Main.WebHome@img.png
      • attach:: Eine notwendige Zeichenkette, die die Ressource als Anhang identifiziert.
      • wikiSeitenName: Eine optionale Zeichenkette, die das Dokument, an das der Anhang angehängt ist, referenziert, siehe "Wikiseitenname" oben.
      • anhangsName: Name des Anhangs, wie er im Wiki gespeichert ist.
    • E-Mail-Adresse in der Form mailto: (emailAdresse) (#Anker ist nicht zulässig). Beispiel: mailto:john@smith.com
      • mailto:: Eine notwendige Zeichenkette, die die Ressource als E-Mail identifiziert.
      • emailAddress: Ziel-E-Mail-Adresse. Beispiel: john@smith.com
  • queryString: Eine optionale Abfragezeichenkette, die Parameter spezifiziert, die in der gerenderten URL verwendet werden. Beispiel: mydata1=5&mydata2=Hallo
  • Anker: Ein optionaler Ankername, der auf einen Anker im referenzierten Link zeigt. In XWiki werden Anker automatisch für Überschriften und Bilder erstellt. Beispiel: HInhaltsverzeichnis
• interWikiAlias: Ein optionales Inter Wiki Alias, entsprechend der Definition in der InterWiki Map (siehe Admin Guide). Dies ist nur für Wikiseitennamen zulässig. Beispiel: wikipedia
• Parameter: Eine optionale Liste mit Parametern, die an den Link weitergegeben werden. Beispiel: rel="__blank" (in neuem Fenster öffnen)

Tabellen

2.0 Tables

Erlaubt es auf einfache Weise Inhalte im Tabellenformat zu erstellen. Parameter für Tabelle, Reihe oder Zelle sind ebenfalls in XWiki Syntax 2.0 unterstützt.

|=Titel 1|=Titel 2
|Wort 1|Wort 2

!=Titel 1!=Titel 2
!!Wort 1!!Wort 2

(% style="background-color:red;text-align:center" %)
|=Titel 1|=(% style="background-color:yellow" %)Titel 2
|Wort 1|Wort 2

{{velocity}}
$xwiki.ssfx.use("js/xwiki/table/table.css")
$xwiki.jsfx.use("js/xwiki/table/tablefilterNsort.js", true)
{{/velocity}}

(% class="grid sortable filterable doOddEven" id="tableid" %)
(% class="sortHeader" %)|=Title 1|=Title 2
|Cell 11|Cell 12
|Cell 21|Cell 22

Bilder

2.0 Images

Funktion	XWiki Syntax 2.0	Ergebnis
Bild von Anhang auf aktueller Seite	image:img.png
Bild von Anhang auf anderer Seite	image:Bereich.Seite@img.png
Bild mit Parametern	[[image:img.png||width="25" height="25"]]
Bild mit Bildunterschrift	[[~[~[XWiki~>~>https://www.xwiki.org~]~] unterstützt Bildunterschriften.>>image:img.png]]	(( ()))
Bild befindlich an URL	image:http://eine/url/img.png

XWiki Syntax 2.0 Bild-Spezifikation

Das vollständige Format eines Bilder ist entweder image: (Verweis) oder [[{caption>>}image: (Verweis) {||Parameter}]]

• caption: Eine optionale Beschriftung. Kann beliebige XWiki 2.0-Syntax enthalten, aber verschachtelte Link-Syntax muss mit ~ maskiert werden. Die Beschriftung wird nur unterstützt, wenn die Bildsyntax der einzige Inhalt eines Absatzes ist. Das Bild mit der Beschriftung kann auch in einen Link eingebettet sein. In diesem Fall enthält der Link das Bild, aber nicht die Beschriftung.
• image: Ein erforderlicher Text, welches die folgenden Angaben als Bild kennzeichnet.
• Verweis: Der Verweis auf das anzuzeigende Bild. Der Verweis kann in folgenden Formaten angegeben werden:
  • URL: Eine URL zu einem externen Bild in dem Format http://pfad/BildName. Beispiel: http://example.org/pfad/bild.png
  • Anhang: Ein Verweis auf einen Anhang im Wiki im Format {{{wikiName:} Bereich.} Seite@} (BildName)
    • wikiName: Ein optionaler Text, welcher den Namen eines Subwikis enthält. Das Bild wird dann in dem entsprechenden Subwiki nachgeschlagen. Beispiel: meinwiki
    • Bereich: Der Name eines Bereiches, in dem das Bild nachgeschlagen wird (optional). Wenn kein Bereich angegeben, wird der aktuelle Bereich verwendet. Beispiel: Main
    • Seite: Der Namen einer Seite, an der das Bild angehangen ist (optional). Wird keine Seite angegeben, wird die aktuelle Seite verwendet. Beispiel: WebHome
    • BildName: Ein erforderlicher Text, welcher den Dateinamen des anzuzeigenden Bildes enthält, wie er im Wiki gespeichert ist.
• Parameter: Eine optionale Liste von durch Leerzeichen getrennten Parametern, die an das Bild durchgereicht werden. Beispiel: width="800" height="600" alt="Ein beispielhaftes Bild" title="Dies ist ein schönes Bild"
  • HTML Attribute: Alle Attribute, welche im HTML Standard vorgesehen sind, werden zu dem erzeugten <img> Element hinzugefügt.
    • style: CSS-Stil Anweisungen, welche auf das Bild angewendet werden. Beispiele: style="float:right;height:50px" (d.h. das Bild wird rechtsbündig eingebettet mit einer Höhe von 50 Pixeln),
      style="style="display:block;margin-left:auto;margin-right:auto;width:80%" (Bild wird zentriert dargestellt in einer Breite von 80% des zur verfügung stehenden Platzes).
      style="vertical-align:bottom" (Der folgende Text startet direkt an unteren Ende des Bildes).
    • height: Die vertikale Grösse des angezeigten Bildes. Der Parameterwert sollte entweder in Bildschirmpixeln angeben werden (Beispiel height="80") oder in prozentualen Anteilen des Anzeigebereichs (Beispiel height="40%")
    • width: Die horizontale Grösse des angezeigten Bildes. Der Parameterwert sollte entweder in Bildschirmpixeln angeben werden (Beispiel width="120") oder in prozentualen Anteilen des Anzeigebereichs (Beispiel width="80%")
    • title: Der Text, der beim Überfahren den Bildes mit dem Mauszeiger angezeigt wird. Beispiel: title="Dies ist ein schönes Bild"
    • alt: Der Text, welcher alternativ angezeigt wird, wenn der Browser das Bild nicht darstellen kann. Da dies im HTML eine Pflichtangabe ist, verwendet XWiki den Dateinamen, wenn kein Wert für alt angegeben wurde. Beispiel: alt="Ein beispielhaftes Bild"
    • ... und mehr: Die offizielle Liste aller unterstützten Attribute kann auf der offiziellen Seite des HTML-Standards (in Englisch) eingesehen werden.

Forgeschritten

Wortgetreu

2.0 Verbatim

Erlaubt es Inhalte einzugeben, die nicht formatiert werden (in anderen Worten wird die XWiki Syntax nicht beachtet).

{{{
mehrzeiliger
**wortgetreuer**
Inhalt
}}}

mehrzeiliger
**wortgetreuer**
Inhalt

Zitate

2.0 Quotations

Erlaubt es einen Text zu zitieren.

> Max hat das gesagt
Ich habe OK gesagt

> Max hat das gesagt
>> Marie hat das geantwortet
Ich hab OK gesagt

Gruppen

2.0 Groups

Gruppen können benutzt werden um ein Dokument "inline" direkt in ein anderes Dokument einzufügen. Dies ermöglicht es beispielsweise komplexe Elemente in einem Listenelement oder in einer Tabellenzelle einzufügen. Gruppen sind durch die folgenden Syntaxelemente begrenzt: (((...))). Eine Gruppe kann eine andere Gruppe beinhalten und es gibt keine Grenzen bei der Verschachtelung.

|=Kopfzeile 1|=Kopfzeile 2|=Kopfzeile 3
|Zelle Eins|(((
= Eingebundenes Dokument =

Ein eingebetteter Absatz.

* Listenelement eins
* Listenelement zwei
  ** Unterelement 1
  ** Unterelement 2
))) | Zelle Drei

Nächster Absatz im Dokument der obersten Ebene

(% class="myClass" style="color:blue" %)(((Blaue Absätze

innerhalb myClass)))

Entziehungszeichen

2.0 Escapes

Erlaubt es XWiki Syntax zu entgehen.

Parameter

2.0 Parameters

Mit der XWiki Syntax 2.0 ist es möglich Parameter an die verschiedenen Syntaxelemente und auch an Textblöcke weiterzugeben. Dies wird beispielsweise benutzt um diese zu gestalten. Sie können jegliche Parameterschlüssel/Wertepaare verwenden, die Sie möchten. Der XHTML Renderer wird diese Parameter als XHTML Attribute an die zugrundeliegende XHTML Representation der verschiedenen Syntaxelemente weitergeben. 

(% class="meineKlasse" style="meinStil" id="meineID" %)
= Überschrift =

<h1 class="meineKlasse" style="meinStil" id="meineID">Überschrift</h1>

Programmierung

Makros

2.0 Macros

In XWiki Syntax 2.0 gibt es genau eine Art von Makros, welche mittels der Syntax {{macroname param1="value1" ... paramN="valueN"}} angegeben werden, zum Beispiel für das {{code}} Makro:

{{code language="java"}}
System.out.println("Hello World!");
{{/code}}

HTML

2.0 HTML

Skripte

2.0 Scripts

{{velocity}}
#set ($var = "whatever")
{{/velocity}}

{{groovy}}
def var = "whatever"
{{/groovy}}