====== Dokuwiki ======
Dokuwiki ist eine in PHP geschriebene Wikisoftware.   

===== Escaping von Sonderzeichen  =====
Dokuwiki wandelt einige doppelte Sonderzeichen in eine Formatierung oder ein anderes Zeichen um. Benötigt man die doppelten Sonderzeichen als solche im Text, können sie mit <code>%%zeichen%%</code> escapet werden:

^Eingabe ohne Escaping ^ Bedeutung ohne Escaping ^ Eingabe mit Escaping^ 
| %%--%% |-- (langer Bindestrich) | <code>%%--%%</code>|
| %%__%% |__unterstrichen__ | <code>%%__%%</code> |
| %%//%% |//kursiv// | <code>%%//%%</code> |
| %%\\%% |Umbruch: Text \\ Text | <code>%%\\%%</code> |

===== relative Links =====
Relative Links zu Seiten außerhalb des Wikis können mit dem this-Tag angelegt werden:
<code>
[[this>../site.html]]
</code>

===== Zeilenumbruch in Listen =====
Ein Zeilenumbruch in einer Liste kann mit einem Doppelbachslash %%\\%% erzeugt werden. Der Text muss dabei in einer Zeile stehen und nach dem Doppelbackslash muss ein Leerzeichen folgen.

Code:
<code dokuwiki>
  * Listenpunkt 1 \\ Zeile 2
  * Listenpunkt 2
</code>
Darstellung:
  * Listenpunkt 1 \\ Zeile 2
  * Listenpunkt 2
===== Liste in Tabelle =====
Listen bzw. Aufzählungen innerhalb von Tabellen lassen sich mit Hilfe des [[https://www.dokuwiki.org/plugin:wrap|Wrap-Plugins]] realisieren.

Code:
<code dokuwiki>
^Wert^Beschreibung^
|A|<WRAP>
  * foo
  * bar
</WRAP>|
</code>
Darstellung:
^Wert^Beschreibung^
|A|<WRAP>
  * foo
  * bar
</WRAP>|

===== Tabelle in Liste =====
Tabellen als Element einer Liste lassen sich ebenfalls mit Hilfe des [[https://www.dokuwiki.org/plugin:wrap|Wrap-Plugins]] realisieren.

Code:
<code dokuwiki>
   * Element A
   * <WRAP>
^Überschrift 1^ Überschrift 2^
|foo |bar|
</WRAP>
  * Element C
</code>
Darstellung:
   * Element A
   * <WRAP>
^Überschrift 1^ Überschrift 2^
|foo |bar|
</WRAP>
  * Element C


===== Tabelle in Tabelle =====
Tabellen innerhalb von Tabellen lassen sich ebenfalls mit Hilfe des [[https://www.dokuwiki.org/plugin:wrap|Wrap-Plugins]] realisieren.

Code:
<code dokuwiki>
^Wert^ Beschreibung^
|A|<WRAP>
^Überschrift 1^ Überschrift 2^
|foo |bar|
</WRAP>|
</code>
Darstellung:
^Wert^ Beschreibung^
|A|<WRAP>
^Überschrift 1^ Überschrift 2^
|foo| bar|
</WRAP>|


===== Sortierbare Tabellen =====
Tabellen können mit dem Plugin [[https://www.dokuwiki.org/plugin:sortablejs|sortablejs]] und den Tags ''<sortable>'' bzw. ''</sortable>'' sortierbar gemacht werden.
Die Tabelle muss eine Titelzeile mit ''^'' besitzen.
Um standardmäßig nach einer Spalte zu sortieren ''<sortable 1>'' bzw. ''<sortable r1>'' für die umgekehrte Reihenfolge.

Beispiel:
<code>
<sortable>
^Überschrift 1 ^Überschrift 1^
|1 |2|
|2 |1|
</sortable>
</code>
<sortable>
^Überschrift 1 ^Überschrift 1^
|1 |2|
|2 |1|
</sortable>


===== Fußnoten in sortierbarer Tabelle =====
Werden Fußnoten in einer sortierbaren Tabelle (mit dem Plugin [[https://www.dokuwiki.org/plugin:sortablejs|sortablejs]]) verwendet, darf keine Leerzeile zwischen Tabelle und schließendem </sortable> stehen, sonst werden alle Fußnoten zweimal eingeblendet: einmal direkt unter der Tabelle und einmal am Ende der Seite:

Aussehen mit Leerzeile:
<sortable>
^Titel((Fußnote 1)) ^
|Zelle 1| 
|Zelle 2| 

</sortable>

Aussehen ohne Leerzeile:
<sortable>
^Titel((Fußnote 2)) ^
|Zelle 1| 
|Zelle 2| 
</sortable>

===== Ausrichtung von Bildern mit Titel =====
Um Bilder auszurichten, die einen Titel (Tooltip) besitzen, müssen die Leerzeichen vor dem ''|'' stehen:
<code dokuwiki>
{{ wiki:dokuwiki-128.png|Rechts}}
{{wiki:dokuwiki-128.png |Links}}
{{ wiki:dokuwiki-128.png |Zentriert}}
</code>
Beispiel:

{{ wiki:dokuwiki-128.png|Rechts}}
{{wiki:dokuwiki-128.png |Links}}
{{ wiki:dokuwiki-128.png |Zentriert}}

===== SVG-Upload =====
Vor dem Release "Igor" war der Upload von SVG-Dateien im Media-Manager deaktiviert.
Um ihn zu erlauben, musste eine Datei ''conf/mime.local.conf'' angelegt bzw. bearbeitet werden mit folgendem Inhalt:
<code>
svg     image/svg+xml
</code>
Ab Igor ist der Upload standardmäßig aktiviert.

<WRAP round info>
SVG-Dateien sind potentiell [[https://owasp.org/www-pdf-archive/Mario_Heiderich_OWASP_Sweden_The_image_that_called_me.pdf|unsicher]]. Daher wird ab Igor eine entsprechende Content Security Policy verwendet, siehe [[https://github.com/splitbrain/dokuwiki/issues/1045|Bugreport]] 
</WRAP>

===== Hinweise =====
Mit dem [[https://www.dokuwiki.org/plugin:wrap|WRAP-Plugin]] lassen sich optisch ansprechende Hinweise erstellen.

^Code ^Darstellung^
|<code><WRAP important round>
Dies ist ein Hinweis.
</WRAP></code>|<WRAP important round>
Dies ist ein Hinweis.
</WRAP>|
|<code><WRAP tip round>
Dies ist ein Tipp.
</WRAP></code>|<WRAP tip round>
Dies ist ein Tipp.
</WRAP>|
|<code><WRAP todo round>
Dies ist ein TODO.
</WRAP></code>|<WRAP todo round>
Dies ist ein TODO.
</WRAP>|
|<code><WRAP info round>
Dies ist eine Info.
</WRAP></code>|<WRAP info round>
Dies ist eine Info.
</WRAP>|
|<code><WRAP alert round>
Dies ist eine Warnung.
</WRAP></code>|<WRAP alert round>
Dies ist eine Warnung.
</WRAP>|

===== Text ein- und ausklappen =====
Mit dem Plugin [[https://www.dokuwiki.org/plugin:folded|folded]] lassen sich ein- und ausklappbare Texte (z.B. "Spoiler") erstellen.

Code (inline):
<code>
Dies ist ein ++Beispieltext | mit einem Teil der nur erscheint, wenn man auf ihn klickt++. Danach geht der Text weiter.
</code>

Darstellung:

Dies ist ein ++Beispieltext | mit einem Teil der nur erscheint, wenn man auf ihn klickt++. Danach geht der Text weiter.

Code (block): 
<code>
Dies ist ein Beispieltext.

++++ Titel |
Dieser Teil erscheint nur, wenn man auf den Titel klickt.
++++
</code>
<WRAP tip round>
Vor den ersten 4 Plussen muss eine Leerzeile stehen.
</WRAP>

Darstellung:

Dies ist ein Beispieltext.

++++ Titel |
Dieser Teil erscheint nur, wenn man auf den Titel klickt.
++++

===== Text nach Bild =====
Möchte man Text nach einem Linksbündigen Bild ausrichten, kann man dies mit ''%%<WRAP clear></WRAP>%%'' erreichen:

Beispiel ohne WRAP clear:
<code>
Lorem Ipsum vor  Bild\\ {{:wiki:dokuwiki-128.png|}} Lorem Ipsum nach Bild
</code>
Lorem Ipsum vor  Bild\\ {{:wiki:dokuwiki-128.png|}} Lorem Ipsum nach Bild

Beispiel mit WRAP clear:
<code>
Lorem Ipsum vor Bild\\
{{:wiki:dokuwiki-128.png|}} <WRAP clear></WRAP>Lorem Ipsum nach Bild
</code>
Lorem Ipsum vor Bild\\
{{:wiki:dokuwiki-128.png|}} <WRAP clear></WRAP>Lorem Ipsum nach Bild

===== System-Status und Debug Informationen =====
Um den System-Status (u.a. Dokuwiki und [[PHP]]-Version) anzeigen zu lassen, hängt man an die URL ''?do=check'' bzw. ''&do=check'' an.
Für [[https://www.dokuwiki.org/devel:debugging|Debuginformationen]] kann man ''?do=debug'' bzw. ''&do=debug'' anhängen, wenn die Option [[https://www.dokuwiki.org/config:allowdebug|allowdebug]] gesetzt ist oder man benutzt die Logging-Funktion (seit Version Igor).  

===== Tastenkürzel =====

^Tasenkürzel^ Aktion^
|''ALT'' + ''S''| Änderungen speichern|
|''ALT'' + ''P'' | Vorschau (Preview)|
|''ALT'' + ''D'' | markierten Text durchstreichen|
|''ALT'' + ''I'' | markierten Text //kursiv// setzen |
|''ALT'' + ''B'' | markierten Text **fett** stetzen|
|''ALT'' + ''U'' | markierten Text __unterstreichen__|
|''ALT'' + ''M'' | markierten Text in ''Festbreite'' setzen|
|''ALT'' + ''L'' | Link-Einfüge-Assistent öffnen|
|''ALT'' + ''1'' bis ''ALT'' + ''5'' | markierten Text als Überschrift der Ebene 1-5|

<WRAP tip round>In Chrome und Firefox muss ''ALT''+''Shift'' statt ''ALT'' gedrückt werden.</WRAP>

===== Links =====
   * [[http://www.dokuwiki.org|Dokuwiki Homepage]]