Inhaltsverzeichnis

Syntax Doku dieses Wikis

Syntaxdoku von der DokuWiki-Seite: https://www.dokuwiki.org/start?id=de:wiki:syntax


Seitenbeginn

Jede Seite sollte grundsätzlich mit dem Seitentitel als Level 1 Überschrift beginnen. Darunter sollte eine horizontale Linie (Editor-Button ziemlich in der Mitte) erzeugt werden. Dann erst kommt der Inhalt. Achtung: Die horizontale Linie erscheint erst unter dem Inhaltsverzeichnis, wenn diese angezeigt wird, siehe oben auf dieser Seite. 

====== Name der Seite ======
  
----

Der Text der Seite beginnt mit einer Leerzeile unter der horizontalen Linie.

Soll die Seite kein Inhaltsverzeichnis haben, wird ganz am Anfang ~~NOTOC~~ notiert

Level 1 Überschrift

Syntax ====== Level 1 Überschrift ====== Erscheint in der Inhaltsangabe!

Level 2 Überschrift

Syntax ===== Level 2 Überschrift ===== Erscheint in der Inhaltsangabe!

Level 3 Überschrift

Syntax ==== Level 3 Überschrift ==== Erscheint in der Inhaltsangabe!

Level 4 Überschrift

Syntax === Level 4 Überschrift ===


Überschriften können mit Wiki-Syntax versehen werden: ===== Irgendwas mit //kursiv// =====. Links sind in Überschriften nicht möglich.

Inhaltsangabe unterdrücken

Syntax ~~NOTOC~~

Inline Kommentare

Nicht sichtbare Kommentare, die nur im Editor erscheinen, Syntax /* Kommentar Text! */

Schriftformatierung

Fetter Text, Syntax **Fetter Text**

KursiverText, Syntax //KursiverText//

Fett + KursiverText, Syntax **//Fett + KursiverText//**

Links

Sowohl externe als auch interne Links haben dieselbe Syntax: **[[https://geoport.lk-vr.de|Externer Link]]** **[[syntax-doku#bilder|Interner Link]]**

Externer Link Interner Link

Links immer fett machen („**“)! Beachte die Pipe als Trenner zwischen URL und Alias-Text in beiden Fällen.

In Überschriften sind Links nicht möglich.

Umbruch (Absatz) einfügen

Einfache Umbrüche werden ignoriert, der Text fließt weiter.

Einzeilige Absätze lassen sich durch einfache Leerzeilen erzeugen.

Mehrere Leerzeilen werden dabei ignoriert, es wird immer ein einfacher Umbruch!

Lösung: Mehrere Umbrüche hintereinander lassen sich


durch doppelte Backslashes erzeugen, Syntax \\. Der doppelte Backslash wird nur erkannt, wenn er am Zeilenende steht oder wenn ihm ein Leerzeichen folgt.

Als Umbruch kann auch die horizontale Linie dienen, vor allem nach col-md-xx Angaben.

Einrückung (Tab)

Ein Tab = 5 Leerzeichen, Syntax <tab>. <tab> ist kein HTML-Tag.

     „Eingerückter Text“

Mehrere Tabs: <tab><tab>

Tabs wirken nur auf die Zeile, nicht auf den Absatz!

Aufzählungen

Unnummerierte Auflistung, Syntax * Listenpunkt ← 2 Leerzeichen, dann Stern, dann 1 Leerzeichen

Unterschiedliche Ebenen einer Liste durch Hinzufügen von weiteren zwei Leerzeichen, Syntax * Listenpunkt ← 4 Leerzeichen, dann Stern, dann 1 Leerzeichen

  • Listenpunkt Ebene 1
    • Listenpunkt Ebene 2

Aufzählungen können auch in Panels eingebettet werden.

Code darstellen

Zwei Leerzeichen vor dem Text markieren ihn als Code-Text.

Deswegen wichtig: Außer bei Code-Text niemals Leerzeichen am Anfang einer Zeile verwenden!

nowiki

Ein //<div class="col-md-12">nowiki-Text<br>mit Gedöns</div>// wird durch den nowiki-Tag gekennzeichnet: Wiki-Syntax und HTML-Auszeichnungen werden als reiner Text angezeigt. (Der drittletzte Button in der Werkzeugleiste des Editors) Syntax <nowiki>**Text**</nowiki>

HTML

HTML-Notierungen müssen mit einem <html> Tag markiert werden, sonst erscheinen sie als normaler Text, Syntax <html><div style=""></div></html>

DIVs

DIVs müssen von html Tags umschlossen werden, sonst werden sie ignoriert
<html><div class="col-md-2" style="border: 3px dotted green">DIVs müssen von html Tags umschlossen werden, sonst werden sie ignoriert</div></html>

Spalten mit DIVs und zugehöriger Class col-md-1 bis col-md-12 erzeugen. "12" ist die volle Breite.
col-md-4

Solange sich DIVs auf 12 oder weniger addieren, werden sie nebeneinander platziert.
col-md-4
col-md-8

Werden DIVs in einem 12er DIV eingebettet und addieren sich die eingebetteten DIVs auf genau 12, werden sie untereinander platziert.
col-md-12
col-md-4
col-md-8
Style-Angaben können manchmal sinnvoll sein, sollten aber in der Regel nicht verwendet werden.

Dieses DIV ist mit der Klassenangabe pull-right an den rechten Rand geschoben, Syntax <div class="col-md-6 pull-right">

Wenn der nachfolgende Text nicht neben dem zuletzt notierten DIV weiter fließen, sondern in einem neuen Absatz beginnen soll, empfiehlt sich das Einfügen einer horizontalen Linie, Syntax ----

Tabellen

Die einzelnen Spalten einer Zeile werden vorne und hinten durch das Pipe-Zeichen eingeschlossen, Syntax | Zeile 1, Spalte 1 | Zeile 1, Spalte 2 | Zeile 1, Spalte 3 |

Soll ein Feld (oder die ganze Zeile, z.B. Header) hervorgehoben werden, dann erfolgt das Einschließen mit dem „Dach“-Zeichen (Taste ^ links neben „1“ und zweimal Leerzeichen), Syntax ^ Zeile 1, Spalte 1 ^ Zeile 1, Spalte 2 ^ Zeile 1, Spalte 3 ^

Leerzeichen vor oder hinter „|“ oder „^“ sind nicht notwendig, aber für die Leserlichkeit besser.

Zeile 1, Spalte 1 Zeile 1, Spalte 2 Zeile 1, Spalte 3
Zeile 1, Spalte 1 Zeile 1, Spalte 2 Zeile 1, Spalte 3

Der Feldtrenner („|“ oder „^“) vor einer Zelle entscheidet über ihr Aussehen, Beispiel ^ Zeile 1, Spalte 1 | Zeile 1, Spalte 2 ^ Zeile 1, Spalte 3 |

Zeile 1, Spalte 1 Zeile 1, Spalte 2 Zeile 1, Spalte 3

Doppelte Spaltenbreite erreicht man durch ein doppeltes Pipe-Zeichen, Syntax ||

Zeile 1, Spalte 1 Zeile 1, Spalte 2 Zeile 1, Spalte 3
Zeile 1, Spalte 1+2 Zeile 1, Spalte 3

Vertikales Verbinden von Spalten durch dreifachen Doppelpunkt in dem Feld, das verbunden werden soll, Syntax :::. Das Feld darf keinen weiteren Inhalt haben.

Zeile 1, Spalte 1 Zeile 1+2, Spalte 2 Zeile 1, Spalte 3
Zeile 2, Spalte 1 Zeile 2, Spalte 3

Die Breite der Tabelle ist immer 100% und wird nur durch umschließende DIVs mit col-md-xx schmaler.

Zeile 1, Spalte 1 Zeile 1, Spalte 2 Zeile 1, Spalte 3

Bilder

Dateinamen klein schreiben und ohne Sonderzeichen!

Wiki-Syntax

Beim Einfügen des Bildes in den Text wird der Dialog zum Hochladen geöffnet. Datei auswählen. Die Datei soll in den jeweiligen Seiten-Namensraum: der Seitenname wird (vor dem Hochladen!) als Namensraum vor den Dateinamen geschrieben, Trennzeichen Doppelpunkt zwischen Namensraum und Dateinamen. Beispiel: thema_abfragen:abfragen-aus_28.png

Das Bild kann aber auch vorab in den Ordner des Seiten-Namensraums hochgeladen werden: ../geoport/data/media/namensraum/. Dann kann die Nennung direkt im Text beim Editieren erfolgen.

Bild in Originalgröße: {{:thema_abfragen:abfragen-aus_28.png}}

Breite vorgeben: {{wiki:thema_abfragen:abfragen-aus_28.png?50px}}

Tooltipp: {{:thema_abfragen:abfragen-aus_28.png|Dies ist ein Titel}}

Ausrichtung links - Leerzeichen zur Rechten innerhalb der geschweiften Klammern: {{:thema_abfragen:abfragen-aus_28.png }}

Ausrichtung rechts - Leerzeichen zur Linken innerhalb der geschweiften Klammern: {{ :thema_abfragen:abfragen-aus_28.png}}

Ausrichtung zentriert - Leerzeichen zur Linken und zur Rechten innerhalb der geschweiften Klammern: {{ :thema_abfragen:abfragen-aus_28.png }}

HTML-Syntax

Der Bild-Tag kann alle Auszeichnungen der Wiki-Syntax haben. Das Bild kann vorab in den Ordner des Seiten-Namensraums hochgeladen werden: ../geoport/data/media/namensraum/. Dann kann die Nennung direkt im Text beim Editieren erfolgen. Wichtig: Komplette Kleinschreibung des Dateinamens! Der Namensraum ist ein Unterordner mit dem gleichen Namen wie die Seite, auf der das Bild erscheint.

Das Bild kann aber auch beim Editieren der Seite hochgeladen werden, siehe oben bei Wiki-Syntax.

In geoport/data/media sollen keine Dateien rumliegen!!! Hier sollen sich nur die Unterordner der Namensräume befinden!

Achtung: Alle Elemente müssen ohne Leerzeichen am Anfang der Zeile beginnen! 

<html>
<div class="image-frame" style="width: 208px">
<div class="image-link">
</html>
{{:syntax-doku:dateiname.png?nolink|200px}}
<html>
<p>
Hier kommt Text rein.
Bildunterschrift oder ähnliches.
Die <p></p> sind wichtig!
Bold ist hier natürlich <b></b>, nicht "**", Kursiv ist hier natürlich <i></i>, nicht "//"
</p>
</div>
</div>
</html>

Wenn das Image in originaler Größe erscheinen soll, muss die originale Breite angegeben und außerdem die width im umschließenden div um 8px größer als die originale Breite notiert werden.

nolink bewirkt, dass das Hovern keinen Tooltipp erzeugt.

Die Breite des Bildes muss im image-frame DIV genauso angegeben werden, wie sie im Image-Tag eingetragen wird, wenn der Rahmen an allen Seiten gleich breit sein soll.

Das Bild mit Rahmen wird vom Text umflossen, wenn beim DIV mit der Class image-frame zusätzlich noch die Class pull-left bzw. pull-right eingetragen wird.

Panels

Es gibt zwei Panels:

Das grüne Panel

Syntax:

<div class="col-md-xx panel-green">

Wenn der <h3> Tag beim grünen Panel entfällt, ist es einfach ein grüner Kasten um den Text.

Das weiße Panel

Syntax:

<div class="col-md-xx panel-white">

Der Rand des weißen Panels (insbesondere nach unten) ist nicht erkennbar.

Achtung: Alle Elemente müssen ohne Leerzeichen am Anfang der Zeile beginnen! 

<html>
<div class="col-md-12">
<div class="col-md-8 panel-green"> 
<div class="panel-heading">
<h3 class="panel-title">Hier kommt die Überschrift. Das Überschrift-DIV kann man weglassen, dann fehlt auch der horizontale Balken.</h3>
</div>
<div class="panel-body">
</html>
Hier kommt der Text.
\\
\\
Absätze mit Doppel-Backslashes
  * Listenpunkte gehen auch
  * Noch einer
<html>
</div>
</div>
</div>
</html>

Wenn das Panel über die volle Breite gehen soll, wird das umschließende erste DIV weggelassen und im Panel-DIV col-md-12 notiert.

Externe Seite als iframe

Externe Seiten via HTTPS einbinden, Syntax {{url>https://geoport.lk-vr.de/somepage.html width,height noscroll noborder alignment|alternate-text}}

URL: Pflicht url>https://domainname.de (HTTPS!) und gegebenenfalls /seitenname.htm

Breite, Höhe: Optional. Wird nur ein Wert angegeben, wird Höhe angenommen. Möglich sind px, em, pt oder %, die Einheit muss angegeben werden. Defaults: Breite 98%, Höhe 400px

noscroll: Optional. Lässt Scrollbalken des Frames verschwinden, wenn die eingebettete Seite größer ist als der Frame

noborder: Optional. Lässt die Border des Frames verschwinden, falls der Browser eine Border zeichnet. Achtung: Es könnte auch das CSS sein, das die Border zeichnet, dann nutzt noborder nichts

alignment: Optional left oder right. Frame wird links oder rechts dargestellt. Default left

alternate text: Optional, mit Pipe getrennt. Text erscheint, wenn die URL keine Seite liefert