XWiki Syntax Hilfe
Zuletzt geändert von xwikiadmin am 2021/11/10 09:01
XWiki Syntax 2.1 » Bearbeiten
XWiki Syntax 2.1: Bearbeiten
Absatz
2.0 Paragraphs
Absätze sind Textelemente, die durch zwei oder mehr neue Zeilen getrennt sind.
Funktion | XWiki Syntax 2.0 | Ergebnis |
---|---|---|
Einfacher Absatz | Dies ist ein Absatz | Dies ist ein Absatz |
Absatz mit mehreren Zeilen | Absatz auf mehreren Zeilen | Absatz auf mehreren Zeilen |
Zwei Absätze | Absatz eins Absatz zwei | Absatz eins Absatz zwei |
Parametrisierter Absatz | (% style="text-align:center;color:blue" %) Zentrierter und blauer Absatz | Zentrierter und blauer Absatz |
Überschriften
2.0 Headings
Funktion | XWiki Syntax 2.1 | Ergebnis |
---|---|---|
Standardüberschriften | = Ebene 1 = == Ebene 2 == === Ebene 3 === ==== Ebene 4 ==== ===== Ebene 5 ===== ====== Ebene 6 ====== | Ebene 1
Ebene 2Ebene 3Ebene 4Ebene 5Ebene 6 |
Parametrisierte Überschrift | (% style="color:blue" %) = Überschrift = | Überschrift |
Überschrift mit XWiki Syntax | === Überschrift mit **fett** === | Überschrift mit fett |
Textformatierung
2.0 Text Formatting
Funktion | XWiki Syntax 2.1 | Ergebnis |
---|---|---|
Fett | **fett** | fett |
Unterstrichen | __unterstrichen__ | unterstrichen |
Kursiv | //kursiv// | kursiv |
Durchgestrichen | --durchgestrichen-- | |
Nichtproportional | ##nichtproportional## | nichtproportional |
Hochgestellt | etwas ^^hochgestellt^^ | etwas hochgestellt |
Tiefgestellt | etwas ,,tiefgestellt,, | etwas tiefgestellt |
Horizontale Linie
2.0 Horizontal Line
Funktion | XWiki Syntax 2.1 | Ergebnis |
---|---|---|
Einfache horizontale Linie | ---- | |
Parametrisierte horizontale Linie | (% style="border-color:blue" %) ---- |
Listen
2.0 Lists
Funktion | XWiki Syntax 2.1 | Ergebnis |
---|---|---|
Aufzählung | * Element 1 ** Element 2 *** Element 3 * Element 4 |
|
Nummerierung | 1. Element 1 11. Element 2 111. Element 3 1. Element 4 |
|
Gemischte Liste | 1. Element 1 1*. Element 2 1*. Element 3 1. Element 4 |
|
Aufzählung (Quadrat) | (% style="list-style-type: square" %) * Element 1 * Element 2 |
|
Aufzählung (Kreis) | (% style="list-style-type: disc" %) * Element 1 * Element 2 |
|
Nummerierung (Kleinbuchstaben) | (% style="list-style-type: lower-alpha" %) * Element 1 * Element 2 |
|
Nummerierung (Großbuchstaben) | (% style="list-style-type: upper-alpha" %) * Element 1 * Element 2 |
|
Nummerierung (kleine römische Zahlen) | (% style="list-style-type: lower-roman" %) * Element 1 * Element 2 |
|
Nummerierung (große römische Zahlen) | (% style="list-style-type: upper-roman" %) * Element 1 * Element 2 |
|
Nummerierung (griechische Kleinbuchstaben) | (% style="list-style-type: lower-greek" %) * Element 1 * Element 2 |
|
Nummerierung (griechische Großbuchstaben) | (% style="list-style-type: upper-greek" %) * Element 1 * Element 2 |
|
Hiragana Liste | (% style="list-style-type: hiragana" %) * Element 1 * Element 2 |
|
Hiragana Iroha Liste | (% style="list-style-type: hiragana-iroha" %) * Element 1 * Element 2 |
|
Katakana Liste | (% style="list-style-type: katakana" %) * Element 1 * Element 2 |
|
Katakana Iroha Liste | (% style="list-style-type: katakana-iroha" %) * Element 1 * Element 2 |
|
Nummerierung (armenisch) | (% style="list-style-type: armenian" %) * Element 1 * Element 2 |
|
Nummerierung (hebräisch) | (% style="list-style-type: hebrew" %) * Element 1 * Element 2 |
|
Nummerierung (georgisch) | (% style="list-style-type: georgian" %) * Element 1 * Element 2 |
|
Nummerierung (CJK Ideogramme) | (% style="list-style-type: cjk-ideographic" %) * Element 1 * Element 2 |
|
Definitionslisten
2.0 Definition Lists
Funktion | XWiki Syntax 2.1 | Ergebnis |
---|---|---|
Standarddefinition | ; Begriff : Definition |
|
Verschachtelte Definitionen | ; Begriff 1 : Definition 1 :; Begriff 2 :: Definition 2 |
|
Parametrisierte Definition | (% 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.
Funktion | XWiki Syntax 2.0 | Ergebnis |
---|---|---|
Zeilenumbruch | Zeile\\Neue Zeile | Zeile Neue Zeile |
Neue Zeile | Zeile Neue Zeile | Zeile Neue Zeile |
Links
2.1 Links
Funktion | XWiki Syntax 2.1 | Ergebnis |
---|---|---|
Link zu Seite im aktuellen Bereich | [[WebHome]] | XWiki |
Link mit Linktext | [[Linktext>>WebHome]] | 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]] | |
Link zu einem Anhang auf einer anderen Seite | [[Text>>attach:Bereich.Seite@img.png]] | |
Link zu einem Anker auf einer Seite | [[Text>>Bereich.Seite||anchor=anchor]] | Text |
Link zu einer Überschrift auf einer Seite | [[Text>>Bereich.Seite||anchor=HMyheading]] | Text |
XWiki Syntax 2.1 Linkspezifikation
Das vollständige Format eines Links ist [Linktext>>] (Ressource) [||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: Eine erforderliche Zeichenkette mit der Linkreferenz in einer der folgenden Formen
- URL: Eine URL in der Form [url:] (Protokoll://Pfad). Beispiele: http://xwiki.org, url:https://svn.xwiki.org/
- url: Eine optionale Zeichenkette, die die Ressource als URL identifiziert.
- Wikiseitenname Referenz in der Form [doc:] [[wikiName:] Bereich.] (Seite). Beispiele: WebHome, Main.WebHome, mywiki:Main.WebHome
- doc: Eine optionale Zeichenkette, die die Ressource als XWiki Dokument identifiziert.
- 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
- doc: Eine optionale Zeichenkette, die die Ressource als XWiki Dokument identifiziert.
- InterWiki Seitenname Referenz in der Form interwiki: (interWikiAlias:) (Seite). Beispiel: interwiki:wikipedia:XWiki
- interwiki: Eine erforderliche Zeichenkette, die die Ressource als einen InterWiki Link identifiziert.
- interWikiAlias: Ein optionales Inter Wiki Alias, entsprechend der Definition in der InterWiki Map (siehe Admin Guide). Beispiel: wikipedia
- Seite: Eine erforderliche Zeichenkette, die den Namen der verknüpften Wikiseite enthält. Beispiel: XWiki
- Anhang: Referenz in der Form attach:{{{(wikiName):}(spaceNameListe).}(seitenName)@}(anhangsName)
- attach: Eine erforderliche Zeichenfolge, die die Referenz als XWiki-Dokumentanhang identifiziert.
- wikiName: Eine optionale Zeichenfolge, die den Namen eines Wikis enthält. Die Bildreferenz zeigt auf ein Bild, das an eine Seite innerhalb dieses Wikis angehängt ist. Wenn kein Wiki angegeben ist, wird das aktuelle Wiki verwendet. Beispiel: mywiki.
- spaceNameListe: Eine optionale, durch Punkte getrennte Liste von Wiki-Bereichs-Namen. Wenn kein Bereich angegeben ist, wird der aktuelle Bereich verwendet. Beispiele: Main, A.B, A.B.C
- seitenName: Eine optionale Zeichenfolge, die den Namen der Wiki-Seite enthält, an die das referenzierte Bild angehängt ist. Beispiel: Welcome
- 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
- Relativer Pfad Referenz auf dem Server in der Form path: (relPfad). Beispiel: path:$doc.getURL('reset') erzeugt Zieladresse http://server.domain.com/xwiki/bin/reset/Space/Page wobei /xwiki/bin/reset/Space/Page durch $doc.getURL('reset') erzeugt wird.
- path: Eine erforderliche Zeichenkette, die die Ressource als relativen Pfad identifiziert.
- relPfad: Eine erforderliche Zeichenkette, die den relativen Pfad der Ressource auf dem Server enthält, die verknüpft werden soll.
- UNC (Windows Explorer) Referenz in der Form unc: (Pfad). Der Link wird als file:// gerendet. Beispiele: unc:C:Windows, unc:~myserverpathimg.png, unc:home/user/somefile
- unc: Eine erforderliche Zeichenkette, die die Ressource als UNC (Windows Explorer) Pfad identifiziert.
- Pfad: Eine erforderliche Zeichenkette, die den lokalen Pfad der Ressource, die dem Nutzer zugänglich ist, enthält. Beispiele: C:Windows, ~myserverpathimg.png, home/user/somefile
- URL: Eine URL in der Form [url:] (Protokoll://Pfad). Beispiele: http://xwiki.org, url:https://svn.xwiki.org/
- Parameter: Eine optionale Liste von Leerzeichen-getrennten Parametern, die an den Link übergeben werden. Beispiel: queryString="mydata1=5&mydata2=Hallo" anchor="HInhaltsverzeichnis" rel="__blank"
- queryString: Eine optionale Abfragezeichenkette, die Parameter spezifiziert, die an die Linkzieladresse angehängt werden und in der gerenderten URL verwendet werden. Beispiel: url:http://domain.com/pfad||queryString="mydata1=5&mydata2=Hello" erzeugt Zieladresse http://domain.com/pfad?mydata1=5&mydata2=Hello
- anchor: Ein optionaler Ankername, der auf einen Anker im referenzierten Link zeigt. In XWiki werden Anker automatisch für Überschriften und Bilder erstellt. Beispiel: url:http://domain.com/pfad||anchor="HInhaltsverzeichnis" erzeugt Zieladresse http://domain.com/pfad#HInhaltsverzeichnis
- rel: Ein optionaler Parameter, der es ermöglicht das Linkziel in einem neuen Fenster zu öffnen. Beispiel: rel="__blank"
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.
Funktion | XWiki Syntax 2.1 | Ergebnis | ||||||
---|---|---|---|---|---|---|---|---|
Standardtabelle | |=Titel 1|=Titel 2 |Wort 1|Wort 2 !=Titel 1!=Titel 2 !!Wort 1!!Wort 2 |
| ||||||
Parametrisierte Tabelle | (% style="background-color:red;text-align:center" %) |=Titel 1|=(% style="background-color:yellow" %)Titel 2 |Wort 1|Wort 2 |
| ||||||
Filterbare, sortierbare Tabelle | {{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.1 Images
Funktion | XWiki Syntax 2.1 | 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 | ![]() |
Vordefiniertes Piktogramm | image:icon:accept | ![]() |
XWiki Syntax 2.1 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.1-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 eines XWiki-Dokuments 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: mywiki
- 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.
- Seiten-Anhang: Ein Verweis in der Form pageAttach:{{{(wikiName):}(seitenNamenListe)/}(anhangName)
- pageAttach: Eine erforderliche Zeichenfolge, die die Referenz als Anhang einer XWiki-Seite identifiziert.
- wikiName: Ein optionaler Text, welcher den Namen eines Subwikis enthält. Das Bild wird dann in dem entsprechenden Subwiki nachgeschlagen. Beispiel: mywiki
- seitenNamenListe: Eine optionale, durch Punkte getrennte Liste von Wiki-Seitennamen. Wenn keine Seite angegeben ist, wird die aktuelle Seite verwendet. Beispiele: Main, A/B, A/B/C
- anhangName: Eine erforderliche Zeichenfolge, die den Namen des an eine Seite angehängten Bildes enthält, wie es im Wiki gespeichert ist. Beispiel: myImage.png
- Piktogramme Ein Verweis mittels des Textes (icon:) (iconName). Beispiel: icon:accept
- icon: Ein erforderlicher Text, welcher die folgende Angabe als Piktogramm kennzeichnet. Piktogramme können nur aus der vorinstallierten Liste der XWiki Icons ausgewählt werden.
- iconName: Ein erforderlicher Text mit dem (englischen) Namen des anzuzeigenden Piktogramms. Beispiel: accept
- Data URIs in der Form (data:) (bilddaten). Beispiel: data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==
- data: Ein erforderlicher Text, welcher die folgende Angabe als Binärdaten zu interpretieren erlaubt, enstprechend dem 'data' URI Schema.
- bilddaten: Angabe zu Dateiformat und Codierung, etwa für PNG-Bilder in Base64-codierung image/png;base64, gefolgt von den Binärdaten des Bildes in der angegebenen textuellen Codierung
- 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.
- 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),
- queryString: Ein optionaler Text, welcher als Abfrageparameter an die URL angehangen wird, unter der das Bild vom Server abgeholt wird. Beispiel: queryString="width=100&height=800&keepAspectRatio=true" (keepAspectRatio=true soll den Server veranlassen, die Seitenverhältnisse des Bildes beizubehalten, wird aber ignoriert, wenn sowohl width als auch height angegeben werden)
- HTML Attribute: Alle Attribute, welche im HTML Standard vorgesehen sind, werden zu dem erzeugten <img> Element hinzugefügt.