====== 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]]**'' **[[https://geoport.lk-vr.de|Externer Link]]** **[[syntax-doku#bilder|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 ''''. ist kein HTML-Tag. "Eingerückter Text" Mehrere Tabs: '''' 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|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 **//
nowiki-Text
mit Gedöns
//
** 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 ''**Text**'' ====== HTML ====== HTML-Notierungen müssen mit einem Tag markiert werden, sonst erscheinen sie als normaler Text, Syntax ''
'' ====== DIVs ======
DIVs müssen von html Tags umschlossen werden, sonst werden sie ignoriert
''
DIVs müssen von html Tags umschlossen werden, sonst werden sie ignoriert
'' \\
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 ''
''
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!
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: ''
'' Wenn der

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

Das weiße Panel

Syntax: ''
'' Der Rand des weißen Panels (insbesondere nach unten) ist nicht erkennbar.
Achtung: Alle Elemente müssen ohne Leerzeichen am Anfang der Zeile beginnen!

Hier kommt die Überschrift. Das Überschrift-DIV kann man weglassen, dann fehlt auch der horizontale Balken.

Hier kommt der Text. \\ \\ Absätze mit Doppel-Backslashes * Listenpunkte gehen auch * Noch einer
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