Unterschiede
Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
Beide Seiten der vorigen Revision Vorhergehende Überarbeitung Nächste Überarbeitung | Vorhergehende Überarbeitung | ||
wiki:syntax [10.06.2025 10:32] – Die DokuWiki-Syntaxreferenz wurde vollständig überarbeitet und um 25+ Plugin-spezifische Syntaxelemente (AddNewPage, BPMN.io, Bureaucracy, Color, DataTables, Icons, Struct, Tag, ToDo, VShare, Wrap etc.), erweiterte Formatierungsoptionen, spezifische Fehle Michael Wegener | wiki:syntax [02.07.2025 05:40] (aktuell) – Mermaid Plugin Syntax-Dokumentation hinzugefügt Jane Alesi | ||
---|---|---|---|
Zeile 28: | Zeile 28: | ||
< | < | ||
Sie können < | Sie können < | ||
+ | Beispiel: H< | ||
</ | </ | ||
- | **Ergebnis: | + | **Ergebnis: |
+ | Beispiel: H< | ||
==== Durchgestrichener Text ==== | ==== Durchgestrichener Text ==== | ||
Zeile 45: | Zeile 47: | ||
oder gefolgt von\\ einem Leerzeichen erkannt werden \\dies passiert ohne. | oder gefolgt von\\ einem Leerzeichen erkannt werden \\dies passiert ohne. | ||
</ | </ | ||
+ | |||
+ | **Ergebnis: | ||
+ | Dies ist Text mit Zeilenumbrüchen\\ | ||
+ | Beachten Sie, dass die zwei Backslashes nur am Zeilenende\\ | ||
+ | oder gefolgt von\\ einem Leerzeichen erkannt werden \\dies passiert ohne. | ||
**Wichtig: | **Wichtig: | ||
Zeile 60: | Zeile 67: | ||
== Ebene 5 == | == Ebene 5 == | ||
</ | </ | ||
+ | |||
+ | **Ergebnis: | ||
+ | ====== Ebene 1 (Hauptüberschrift) ====== | ||
+ | ===== Ebene 2 ===== | ||
+ | ==== Ebene 3 ==== | ||
+ | === Ebene 4 === | ||
+ | == Ebene 5 == | ||
==== Automatisches Inhaltsverzeichnis ==== | ==== Automatisches Inhaltsverzeichnis ==== | ||
Zeile 69: | Zeile 83: | ||
---- | ---- | ||
</ | </ | ||
+ | |||
+ | **Ergebnis: | ||
+ | ---- | ||
+ | |||
Vier oder mehr Bindestriche erzeugen eine horizontale Linie. | Vier oder mehr Bindestriche erzeugen eine horizontale Linie. | ||
Zeile 82: | Zeile 100: | ||
< | < | ||
</ | </ | ||
+ | |||
+ | **Ergebnis: | ||
+ | http:// | ||
+ | [[http:// | ||
+ | [[http:// | ||
+ | < | ||
==== Interne Links ==== | ==== Interne Links ==== | ||
Zeile 90: | Zeile 114: | ||
[[syntax# | [[syntax# | ||
</ | </ | ||
+ | |||
+ | **Ergebnis: | ||
+ | [[seitenname]]\\ | ||
+ | [[seitenname|Link-Text]]\\ | ||
+ | [[namespace: | ||
+ | [[syntax# | ||
==== Interwiki-Links ==== | ==== Interwiki-Links ==== | ||
Zeile 96: | Zeile 126: | ||
[[wp> | [[wp> | ||
</ | </ | ||
+ | |||
+ | **Ergebnis: | ||
+ | [[doku> | ||
+ | [[wp> | ||
==== Windows-Freigaben ==== | ==== Windows-Freigaben ==== | ||
Zeile 101: | Zeile 135: | ||
[[\\server\freigabe|Diese Freigabe]] | [[\\server\freigabe|Diese Freigabe]] | ||
</ | </ | ||
+ | |||
+ | **Ergebnis: | ||
+ | [[\\server\freigabe|Diese Freigabe]] | ||
==== Bild-Links ==== | ==== Bild-Links ==== | ||
Zeile 106: | Zeile 143: | ||
[[http:// | [[http:// | ||
</ | </ | ||
+ | |||
+ | **Ergebnis: | ||
+ | [[http:// | ||
---- | ---- | ||
Zeile 118: | Zeile 158: | ||
{{https:// | {{https:// | ||
</ | </ | ||
+ | |||
+ | **Ergebnis: | ||
+ | {{wiki: | ||
+ | {{wiki: | ||
+ | {{wiki: | ||
+ | {{https:// | ||
==== Bildausrichtung ==== | ==== Bildausrichtung ==== | ||
Zeile 125: | Zeile 171: | ||
{{ wiki: | {{ wiki: | ||
</ | </ | ||
+ | |||
+ | **Ergebnis: | ||
+ | |||
+ | {{ wiki: | ||
+ | |||
+ | {{wiki: | ||
+ | |||
+ | {{ wiki: | ||
==== Bildtitel und Alt-Text ==== | ==== Bildtitel und Alt-Text ==== | ||
Zeile 130: | Zeile 184: | ||
{{ wiki: | {{ wiki: | ||
</ | </ | ||
+ | |||
+ | **Ergebnis: | ||
+ | {{ wiki: | ||
==== Unterstützte Medienformate ==== | ==== Unterstützte Medienformate ==== | ||
Zeile 143: | Zeile 200: | ||
{{wiki: | {{wiki: | ||
</ | </ | ||
+ | |||
+ | **Ergebnis: | ||
+ | {{wiki: | ||
==== Fallback-Formate für Videos ==== | ==== Fallback-Formate für Videos ==== | ||
Zeile 159: | Zeile 219: | ||
* Ein weiterer Punkt | * Ein weiterer Punkt | ||
</ | </ | ||
+ | |||
+ | **Ergebnis: | ||
+ | * Dies ist eine Liste | ||
+ | * Der zweite Punkt | ||
+ | * Sie können verschiedene Ebenen haben | ||
+ | * Noch ein Unterpunkt | ||
+ | * Ein weiterer Punkt | ||
==== Geordnete Listen ==== | ==== Geordnete Listen ==== | ||
Zeile 168: | Zeile 235: | ||
- Zurück zur ersten Ebene | - Zurück zur ersten Ebene | ||
</ | </ | ||
+ | |||
+ | **Ergebnis: | ||
+ | - Die gleiche Liste, aber nummeriert | ||
+ | - Ein weiterer Punkt | ||
+ | - Verwenden Sie Einrückung für tiefere Ebenen | ||
+ | - Das war's | ||
+ | - Zurück zur ersten Ebene | ||
==== Gemischte Listen ==== | ==== Gemischte Listen ==== | ||
Zeile 176: | Zeile 250: | ||
* Zurück zu ungeordnet | * Zurück zu ungeordnet | ||
</ | </ | ||
+ | |||
+ | **Ergebnis: | ||
+ | * Ungeordnet | ||
+ | - Geordnet | ||
+ | - Noch einer | ||
+ | * Zurück zu ungeordnet | ||
---- | ---- | ||
Zeile 187: | Zeile 267: | ||
| Zeile 2 Sp 1 | Zeile 2 Sp 2 | Zeile 2 Sp 3 | | | Zeile 2 Sp 1 | Zeile 2 Sp 2 | Zeile 2 Sp 3 | | ||
</ | </ | ||
+ | |||
+ | **Ergebnis: | ||
+ | ^ Überschrift 1 ^ Überschrift 2 ^ Überschrift 3 ^ | ||
+ | | Zeile 1 Sp 1 | Zeile 1 Sp 2 | Zeile 1 Sp 3 | | ||
+ | | Zeile 2 Sp 1 | Zeile 2 Sp 2 | Zeile 2 Sp 3 | | ||
==== Colspan (Zellen horizontal verbinden) ==== | ==== Colspan (Zellen horizontal verbinden) ==== | ||
Zeile 195: | Zeile 280: | ||
| Zeile 3 Sp 1 | Zeile 3 Sp 2 | Zeile 3 Sp 3 | | | Zeile 3 Sp 1 | Zeile 3 Sp 2 | Zeile 3 Sp 3 | | ||
</ | </ | ||
+ | |||
+ | **Ergebnis: | ||
+ | ^ Überschrift 1 ^ Überschrift 2 ^ Überschrift 3 ^ | ||
+ | | Zeile 1 Sp 1 | Zeile 1 Sp 2 | Zeile 1 Sp 3 | | ||
+ | | Zeile 2 Sp 1 | ein colspan (beachten Sie die doppelte Pipe) || | ||
+ | | Zeile 3 Sp 1 | Zeile 3 Sp 2 | Zeile 3 Sp 3 | | ||
==== Vertikale Überschriften ==== | ==== Vertikale Überschriften ==== | ||
Zeile 202: | Zeile 293: | ||
^ Überschrift 4 | Zeile 2 Sp 2 | Zeile 2 Sp 3 | | ^ Überschrift 4 | Zeile 2 Sp 2 | Zeile 2 Sp 3 | | ||
</ | </ | ||
+ | |||
+ | **Ergebnis: | ||
+ | | ^ Überschrift 1 ^ Überschrift 2 ^ | ||
+ | ^ Überschrift 3 | Zeile 1 Sp 2 | Zeile 1 Sp 3 | | ||
+ | ^ Überschrift 4 | Zeile 2 Sp 2 | Zeile 2 Sp 3 | | ||
==== Rowspan (Zellen vertikal verbinden) ==== | ==== Rowspan (Zellen vertikal verbinden) ==== | ||
Zeile 210: | Zeile 306: | ||
| Zeile 3 Sp 1 | ::: | Zeile 3 Sp 3 | | | Zeile 3 Sp 1 | ::: | Zeile 3 Sp 3 | | ||
</ | </ | ||
+ | |||
+ | **Ergebnis: | ||
+ | ^ Überschrift 1 ^ Überschrift 2 ^ Überschrift 3 ^ | ||
+ | | Zeile 1 Sp 1 | diese Zelle erstreckt sich vertikal | Zeile 1 Sp 3 | | ||
+ | | Zeile 2 Sp 1 | ::: | Zeile 2 Sp 3 | | ||
+ | | Zeile 3 Sp 1 | ::: | Zeile 3 Sp 3 | | ||
==== Tabellenausrichtung ==== | ==== Tabellenausrichtung ==== | ||
Zeile 218: | Zeile 320: | ||
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | ||
</ | </ | ||
+ | |||
+ | **Ergebnis: | ||
+ | ^ | ||
+ | | rechts| | ||
+ | |links | ||
+ | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | ||
**Ausrichtungsregeln: | **Ausrichtungsregeln: | ||
Zeile 232: | Zeile 340: | ||
Dies ist '' | Dies ist '' | ||
</ | </ | ||
+ | |||
+ | **Ergebnis: | ||
+ | Dies ist '' | ||
==== Code-Blöcke ==== | ==== Code-Blöcke ==== | ||
- | < | + | **Ergebnis: |
< | < | ||
Dies ist vorformatierter Code, alle Leerzeichen bleiben erhalten: wie <-hier | Dies ist vorformatierter Code, alle Leerzeichen bleiben erhalten: wie <-hier | ||
- | </ | ||
</ | </ | ||
Zeile 246: | Zeile 356: | ||
</ | </ | ||
</ | </ | ||
+ | |||
+ | **Ergebnis: | ||
+ | < | ||
+ | Dies ist ziemlich dasselbe, aber Sie könnten es verwenden, um zu zeigen, dass Sie eine Datei zitiert haben. | ||
+ | </ | ||
==== Syntax-Highlighting ==== | ==== Syntax-Highlighting ==== | ||
Zeile 260: | Zeile 375: | ||
} | } | ||
</ | </ | ||
+ | </ | ||
+ | |||
+ | **Ergebnis: | ||
+ | <code java> | ||
+ | /** | ||
+ | * Die HelloWorldApp-Klasse implementiert eine Anwendung, die | ||
+ | * einfach "Hello World!" | ||
+ | */ | ||
+ | class HelloWorldApp { | ||
+ | public static void main(String[] args) { | ||
+ | System.out.println(" | ||
+ | } | ||
+ | } | ||
</ | </ | ||
Zeile 271: | Zeile 399: | ||
</ | </ | ||
</ | </ | ||
+ | |||
+ | **Ergebnis: | ||
+ | <file php myexample.php> | ||
+ | <?php echo "hello world!"; | ||
+ | </ | ||
==== Code ohne Highlighting ==== | ==== Code ohne Highlighting ==== | ||
Zeile 277: | Zeile 410: | ||
Kein Syntax-Highlighting, | Kein Syntax-Highlighting, | ||
</ | </ | ||
+ | </ | ||
+ | |||
+ | **Ergebnis: | ||
+ | <code - myfile.foo> | ||
+ | Kein Syntax-Highlighting, | ||
</ | </ | ||
Zeile 289: | Zeile 427: | ||
</ | </ | ||
</ | </ | ||
+ | |||
+ | **Ergebnis: | ||
+ | < | ||
+ | Dies ist Text, der Adressen wie diese enthält: http:// | ||
+ | </ | ||
==== Prozent-Zeichen ==== | ==== Prozent-Zeichen ==== | ||
Zeile 294: | Zeile 437: | ||
Das Gleiche gilt für %%// | Das Gleiche gilt für %%// | ||
</ | </ | ||
+ | |||
+ | **Ergebnis: | ||
+ | Das Gleiche gilt für %%// | ||
---- | ---- | ||
Zeile 344: | Zeile 490: | ||
DokuWiki konvertiert häufig verwendete Emoticons in ihre grafischen Entsprechungen: | DokuWiki konvertiert häufig verwendete Emoticons in ihre grafischen Entsprechungen: | ||
- | * '' | + | < |
- | * '' | + | 8-) 8-O :-( :-) =) :-/ :-\ :-? :-D :-P :-O :-X :-| ;-) ^_^ m( :?: :!: LOL FIXME DELETEME |
- | * '' | + | </ |
- | * '' | + | |
- | * '' | + | **Ergebnis:**\\ |
- | * '' | + | 8-) 8-O :-( :-) =) :-/ :-\ :-? :-D :-P :-O :-X :-| ;-) ^_^ m( :?: :!: LOL FIXME DELETEME |
- | * '' | + | |
- | * '' | + | |
- | * '' | + | |
- | * '' | + | |
- | * '' | + | |
- | * '' | + | |
- | * '' | + | |
- | * '' | + | |
- | * '' | + | |
- | * '' | + | |
- | * '' | + | |
- | * '' | + | |
- | * '' | + | |
- | * '' | + | |
- | * '' | + | |
==== Typografische Konvertierungen ==== | ==== Typografische Konvertierungen ==== | ||
Zeile 383: | Zeile 514: | ||
{{rss> | {{rss> | ||
</ | </ | ||
+ | |||
+ | **Ergebnis: | ||
+ | {{rss> | ||
**Parameter: | **Parameter: | ||
Zeile 401: | Zeile 535: | ||
~~NOTOC~~ | ~~NOTOC~~ | ||
</ | </ | ||
- | Verhindert die automatische Erstellung eines Inhaltsverzeichnisses. | + | |
+ | **Ergebnis: | ||
==== NOCACHE - Cache deaktivieren ==== | ==== NOCACHE - Cache deaktivieren ==== | ||
Zeile 407: | Zeile 542: | ||
~~NOCACHE~~ | ~~NOCACHE~~ | ||
</ | </ | ||
- | Zwingt DokuWiki, die Seite bei jedem Aufruf neu zu rendern. | + | |
+ | **Ergebnis: | ||
---- | ---- | ||
Zeile 421: | Zeile 557: | ||
{{NEWPAGE> | {{NEWPAGE> | ||
</ | </ | ||
+ | |||
+ | **Ergebnis: | ||
+ | {{NEWPAGE}}\\ | ||
+ | {{NEWPAGE> | ||
+ | {{NEWPAGE> | ||
==== BPMN.io Plugin ==== | ==== BPMN.io Plugin ==== | ||
Zeile 428: | Zeile 569: | ||
</ | </ | ||
</ | </ | ||
+ | |||
+ | **Ergebnis: | ||
==== Bureaucracy Plugin ==== | ==== Bureaucracy Plugin ==== | ||
Zeile 442: | Zeile 585: | ||
</ | </ | ||
</ | </ | ||
+ | |||
+ | **Ergebnis: | ||
==== Color Plugin ==== | ==== Color Plugin ==== | ||
Zeile 449: | Zeile 594: | ||
<color # | <color # | ||
</ | </ | ||
+ | |||
+ | **Ergebnis: | ||
+ | <color green> | ||
+ | <color blue/ | ||
+ | <color # | ||
==== DataTables Plugin ==== | ==== DataTables Plugin ==== | ||
Zeile 458: | Zeile 608: | ||
</ | </ | ||
</ | </ | ||
+ | |||
+ | **Ergebnis: | ||
==== Icons Plugin ==== | ==== Icons Plugin ==== | ||
Zeile 465: | Zeile 617: | ||
{{glyphicon> | {{glyphicon> | ||
</ | </ | ||
+ | |||
+ | **Ergebnis: | ||
+ | {{icon> | ||
+ | {{fa> | ||
+ | {{glyphicon> | ||
==== Struct Plugin ==== | ==== Struct Plugin ==== | ||
Zeile 474: | Zeile 631: | ||
---- | ---- | ||
</ | </ | ||
+ | |||
+ | **Ergebnis: | ||
==== Tag Plugin ==== | ==== Tag Plugin ==== | ||
Zeile 481: | Zeile 640: | ||
{{count> | {{count> | ||
</ | </ | ||
+ | |||
+ | **Ergebnis: | ||
+ | {{tag> | ||
+ | {{topic> | ||
+ | {{count> | ||
==== ToDo Plugin ==== | ==== ToDo Plugin ==== | ||
Zeile 488: | Zeile 652: | ||
<todo @benutzer> | <todo @benutzer> | ||
</ | </ | ||
+ | |||
+ | **Ergebnis: | ||
+ | < | ||
+ | <todo #> | ||
+ | <todo @benutzer> | ||
==== VShare Plugin ==== | ==== VShare Plugin ==== | ||
Zeile 495: | Zeile 664: | ||
{{youtube> | {{youtube> | ||
</ | </ | ||
+ | |||
+ | **Ergebnis: | ||
==== Wrap Plugin ==== | ==== Wrap Plugin ==== | ||
Zeile 504: | Zeile 675: | ||
<wrap classes #id width : | <wrap classes #id width : | ||
</ | </ | ||
+ | |||
+ | **Ergebnis: | ||
---- | ---- | ||
Zeile 570: | Zeile 743: | ||
Dies verlinkt zu [[syntax# | Dies verlinkt zu [[syntax# | ||
</ | </ | ||
+ | |||
+ | **Ergebnis: | ||
+ | Dies verlinkt zu [[syntax# | ||
==== Namespaces ==== | ==== Namespaces ==== | ||
Zeile 575: | Zeile 751: | ||
[[some: | [[some: | ||
</ | </ | ||
+ | |||
+ | **Ergebnis: | ||
+ | [[some: | ||
+ | |||
Verwenden Sie Doppelpunkte, | Verwenden Sie Doppelpunkte, | ||
Zeile 586: | Zeile 766: | ||
{{tag> | {{tag> | ||
+ | |||
+ | ---- | ||
+ | |||
+ | ===== 18. Reveal.js Slideshow Plugin ===== | ||
+ | |||
+ | ==== Plugin-Übersicht ==== | ||
+ | Das **Reveal.js Plugin** ermöglicht es, DokuWiki-Seiten in professionelle HTML5-Präsentationen umzuwandeln. Basierend auf dem beliebten Reveal.js Framework von Hakim El Hattab. | ||
+ | |||
+ | * **GitHub Repository: | ||
+ | * **Reveal.js Version:** 3.9.2 | ||
+ | * **DokuWiki Kompatibilität: | ||
+ | * **Lizenz:** MIT (Reveal.js Framework) | ||
+ | |||
+ | ==== Grundlegende Verwendung ==== | ||
+ | |||
+ | === Präsentation aktivieren === | ||
+ | < | ||
+ | ~~REVEAL~~ | ||
+ | </ | ||
+ | |||
+ | **Ergebnis: | ||
+ | |||
+ | === Theme-Auswahl === | ||
+ | < | ||
+ | ~~REVEAL white~~ | ||
+ | ~~REVEAL theme=sky& | ||
+ | </ | ||
+ | |||
+ | **Verfügbare Themes:** | ||
+ | * '' | ||
+ | * '' | ||
+ | * '' | ||
+ | |||
+ | ==== Folien-Struktur ==== | ||
+ | |||
+ | === Header-basierte Folien === | ||
+ | < | ||
+ | ====== Hauptfolie (H1) ====== | ||
+ | Inhalt der ersten Folie | ||
+ | |||
+ | ===== Horizontale Folie (H2) ===== | ||
+ | Inhalt der zweiten Folie | ||
+ | |||
+ | ==== Vertikale Folie (H3) ==== | ||
+ | Unterfolie (vertikal verschachtelt) | ||
+ | |||
+ | === Weitere vertikale Folie === | ||
+ | Noch eine Unterfolie | ||
+ | </ | ||
+ | |||
+ | **Folien-Hierarchie: | ||
+ | * **H1 (======):** Hauptfolien (horizontal) | ||
+ | * **H2 (=====):** Horizontale Folien | ||
+ | * **H3 (====) und tiefer:** Vertikale Folien (verschachtelt) | ||
+ | |||
+ | === Konfigurierbare Folien-Ebenen === | ||
+ | < | ||
+ | ~~REVEAL horizontal_slide_level=1~~ | ||
+ | </ | ||
+ | |||
+ | **horizontal_slide_level Optionen:** | ||
+ | * '' | ||
+ | * '' | ||
+ | |||
+ | ==== Hintergrund-Gestaltung ==== | ||
+ | |||
+ | === Einfache Hintergründe === | ||
+ | < | ||
+ | {{background> | ||
+ | ===== Folie mit rotem Hintergrund ===== | ||
+ | |||
+ | {{background>: | ||
+ | ===== Folie mit Bild-Hintergrund ===== | ||
+ | </ | ||
+ | |||
+ | === Erweiterte Hintergrund-Optionen === | ||
+ | < | ||
+ | {{background> | ||
+ | ===== Folie mit komplexem Hintergrund ===== | ||
+ | </ | ||
+ | |||
+ | **Hintergrund-Parameter: | ||
+ | * **Farben:** HTML-Farbnamen, | ||
+ | * **Bilder:** DokuWiki-Medien ('': | ||
+ | * **Größe: | ||
+ | * **Position: | ||
+ | * **Wiederholung: | ||
+ | * **Übergang: | ||
+ | |||
+ | ==== Alternative Folien-Indikatoren ==== | ||
+ | |||
+ | === Horizontale Folien === | ||
+ | < | ||
+ | ---- orange wiki: | ||
+ | |||
+ | Folien-Inhalt hier | ||
+ | |||
+ | <---- | ||
+ | </ | ||
+ | |||
+ | **Syntax-Elemente: | ||
+ | * '' | ||
+ | * ''< | ||
+ | * '' | ||
+ | * ''<< | ||
+ | |||
+ | === Parameter für alternative Indikatoren === | ||
+ | < | ||
+ | ---- salmon wiki: | ||
+ | </ | ||
+ | |||
+ | **Übergangs-Optionen: | ||
+ | * **Folien-Übergang: | ||
+ | * **Richtung: | ||
+ | * **Geschwindigkeit: | ||
+ | |||
+ | ==== Fragmente (Schrittweise Anzeige) ==== | ||
+ | |||
+ | === Inline-Fragmente === | ||
+ | < | ||
+ | < | ||
+ | |||
+ | < | ||
+ | |||
+ | < | ||
+ | </ | ||
+ | |||
+ | === Block-Fragmente === | ||
+ | < | ||
+ | < | ||
+ | ==== Überschrift erscheint komplett ==== | ||
+ | * Listenpunkt 1 | ||
+ | * Listenpunkt 2 | ||
+ | * Listenpunkt 3 | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | === Fragment-Listen === | ||
+ | < | ||
+ | < | ||
+ | * Punkt 1 (erscheint einzeln) | ||
+ | * Punkt 2 (erscheint einzeln) | ||
+ | * Punkt 3 (erscheint einzeln) | ||
+ | </ | ||
+ | |||
+ | < | ||
+ | * Alle Punkte (erscheinen zusammen) | ||
+ | * Auch bei aktivierter build_all_lists Option | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | === Fragment-Stile und Indizes === | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | |||
+ | **Fragment-Stile: | ||
+ | * '' | ||
+ | * '' | ||
+ | * '' | ||
+ | * '' | ||
+ | |||
+ | ==== Sprecher-Notizen ==== | ||
+ | |||
+ | < | ||
+ | ===== Folie-Titel ===== | ||
+ | Sichtbarer Folien-Inhalt | ||
+ | |||
+ | < | ||
+ | * Notiz für den Sprecher | ||
+ | * Nur im Sprecher-Modus sichtbar (Taste ' | ||
+ | * Listen sind hier nie inkrementell | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | **Sprecher-Modus aktivieren: | ||
+ | |||
+ | ==== Fußzeilen ==== | ||
+ | |||
+ | === Globale Fußzeile === | ||
+ | < | ||
+ | <wrap footer> | ||
+ | Firmenlogo oder Copyright-Hinweis | ||
+ | </ | ||
+ | |||
+ | ====== Erste Folie ====== | ||
+ | Inhalt... | ||
+ | </ | ||
+ | |||
+ | === Fußzeile für einzelne Folien deaktivieren === | ||
+ | < | ||
+ | {{no-footer}} | ||
+ | ===== Folie ohne Fußzeile ===== | ||
+ | |||
+ | {{background>: | ||
+ | ===== Folie mit Hintergrund ohne Fußzeile ===== | ||
+ | |||
+ | ---- no-footer ----> | ||
+ | Alternative Folien-Syntax ohne Fußzeile | ||
+ | </ | ||
+ | |||
+ | ==== Konfigurationsoptionen ==== | ||
+ | |||
+ | === Vollständige Parameter-Syntax === | ||
+ | < | ||
+ | ~~REVEAL theme=sky& | ||
+ | </ | ||
+ | |||
+ | === Wichtige Konfigurationsparameter === | ||
+ | |||
+ | ^ Parameter ^ Werte ^ Beschreibung ^ | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | |||
+ | ==== PDF-Export ==== | ||
+ | |||
+ | === Export-URL === | ||
+ | < | ||
+ | Normale URL: | ||
+ | http:// | ||
+ | |||
+ | PDF-Export URL: | ||
+ | http:// | ||
+ | </ | ||
+ | |||
+ | === Export-Schritte === | ||
+ | - URL mit ''& | ||
+ | - Seite lädt im PDF-Export-Modus | ||
+ | - Browser-Druckfunktion verwenden (Strg+P) | ||
+ | - Als PDF speichern | ||
+ | |||
+ | **Empfohlene Browser:** Chrome oder Chromium für beste Ergebnisse. | ||
+ | |||
+ | ==== Best Practices ==== | ||
+ | |||
+ | === Folien-Design === | ||
+ | * **Wenig Text:** Maximal 6-8 Zeilen pro Folie | ||
+ | * **Große Schrift:** Gut lesbar auch von hinten | ||
+ | * **Kontrast: | ||
+ | * **Bilder optimieren: | ||
+ | |||
+ | === Navigation === | ||
+ | * **Tastatur: | ||
+ | * **Maus:** Klick für nächste Folie | ||
+ | * **Touch:** Wischen auf mobilen Geräten | ||
+ | * **Übersicht: | ||
+ | |||
+ | === Performance === | ||
+ | * '' | ||
+ | * Bilder vor Upload komprimieren | ||
+ | * Nicht zu viele Fragmente pro Folie | ||
+ | |||
+ | === Kompatibilität === | ||
+ | * **Include Plugin:** Siehe Kompatibilitäts-Fix in Plugin-Dokumentation | ||
+ | * **MathJax: | ||
+ | * **Wrap Plugin:** Vollständig kompatibel | ||
+ | |||
+ | ==== Beispiel-Präsentation ==== | ||
+ | |||
+ | < | ||
+ | ~~REVEAL white~~ | ||
+ | |||
+ | ====== Meine Präsentation ====== | ||
+ | **Untertitel hier** | ||
+ | |||
+ | Datum und Autor | ||
+ | |||
+ | ===== Agenda ===== | ||
+ | * Punkt 1 | ||
+ | * Punkt 2 | ||
+ | * Punkt 3 | ||
+ | |||
+ | {{background> | ||
+ | ===== Hauptteil ===== | ||
+ | |||
+ | < | ||
+ | |||
+ | < | ||
+ | |||
+ | < | ||
+ | ==== Detaillierte Informationen ==== | ||
+ | * Detail A | ||
+ | * Detail B | ||
+ | * Detail C | ||
+ | </ | ||
+ | |||
+ | ==== Unterfolie ==== | ||
+ | Vertikale Navigation mit Pfeiltasten | ||
+ | |||
+ | < | ||
+ | Sprecher-Notizen: | ||
+ | - Punkt A erwähnen | ||
+ | - Fragen stellen | ||
+ | - Auf nächste Folie überleiten | ||
+ | </ | ||
+ | |||
+ | ===== Zusammenfassung ===== | ||
+ | * Wichtigste Erkenntnisse | ||
+ | * Nächste Schritte | ||
+ | * Kontakt-Informationen | ||
+ | |||
+ | ===== Vielen Dank! ===== | ||
+ | **Fragen?** | ||
+ | |||
+ | {{background>: | ||
+ | </ | ||
+ | |||
+ | ==== Fehlerbehebung ==== | ||
+ | |||
+ | === Häufige Probleme === | ||
+ | |||
+ | ^ Problem ^ Lösung ^ | ||
+ | | Präsentation startet nicht | '' | ||
+ | | Folien werden nicht getrennt | Header-Syntax prüfen (====== vs =====) | | ||
+ | | Hintergrund wird nicht angezeigt | Bild-Pfad und Dateiformat überprüfen | | ||
+ | | Fragmente funktionieren nicht | Syntax von ''< | ||
+ | | PDF-Export fehlerhaft | Chrome/ | ||
+ | |||
+ | === Bekannte Einschränkungen === | ||
+ | * **PHP 7.4+ erforderlich: | ||
+ | * **DokuWiki " | ||
+ | * **Plugin-Konflikte: | ||
+ | * **MathJax: | ||
+ | |||
+ | === Debug-Tipps === | ||
+ | * Browser-Entwicklertools für JavaScript-Fehler | ||
+ | * '' | ||
+ | * Plugin-Manager für Aktivierung/ | ||
+ | * DokuWiki-Logs für Server-seitige Fehler | ||
+ | |||
+ | ---- | ||
+ | |||
+ | **Das Reveal.js Plugin erweitert DokuWiki um professionelle Präsentationsfähigkeiten. Für detaillierte Informationen und Updates besuchen Sie das [[https:// | ||
+ | |||
+ | {{tag> | ||
+ | |||
+ | ---- | ||
+ | |||
+ | ===== 19. Mermaid Plugin ===== | ||
+ | |||
+ | ==== Plugin-Übersicht ==== | ||
+ | Das **Mermaid Plugin** ermöglicht die Erstellung von Diagrammen und Flussdiagrammen mit der JavaScript-basierten Bibliothek [Mermaid](https:// | ||
+ | |||
+ | * **GitHub Repository: | ||
+ | * **Mermaid Version:** 11.6.0 (lokal gehostet) | ||
+ | * **DokuWiki Kompatibilität: | ||
+ | * **PHP Anforderung: | ||
+ | * **Lizenz:** GNU GPL v2.0 (Plugin), MIT (Mermaid.js) | ||
+ | |||
+ | ==== Grundlegende Verwendung ==== | ||
+ | |||
+ | === Einfaches Diagramm === | ||
+ | < | ||
+ | < | ||
+ | graph TD | ||
+ | A[Start] --> B{Entscheidung} | ||
+ | B -->|Ja| C[Aktion 1] | ||
+ | B --> | ||
+ | C --> E[Ende] | ||
+ | D --> E | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | **Ergebnis: | ||
+ | |||
+ | === Grundlegende Syntax-Regeln === | ||
+ | * **Container: | ||
+ | * **Diagramm-Typ: | ||
+ | * **Knoten:** Definiert mit verschiedenen Formen: '' | ||
+ | * **Verbindungen: | ||
+ | |||
+ | ==== Unterstützte Diagramm-Typen ==== | ||
+ | |||
+ | === Flussdiagramme (Flowcharts) === | ||
+ | < | ||
+ | < | ||
+ | flowchart TD | ||
+ | A[Rechteck] --> B(Runde Ecken) | ||
+ | B --> C{Raute} | ||
+ | C -->|Ja| D[Ergebnis 1] | ||
+ | C --> | ||
+ | D --> F((Kreis)) | ||
+ | E --> F | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | **Richtungen: | ||
+ | * '' | ||
+ | * '' | ||
+ | * '' | ||
+ | * '' | ||
+ | |||
+ | === Sequenzdiagramme === | ||
+ | < | ||
+ | < | ||
+ | sequenceDiagram | ||
+ | participant A as Kunde | ||
+ | participant B as Server | ||
+ | participant C as Datenbank | ||
+ | | ||
+ | A->> | ||
+ | B->> | ||
+ | C-->> | ||
+ | B-->> | ||
+ | | ||
+ | Note over A,C: Kommunikation beendet | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | **Pfeil-Typen: | ||
+ | * '' | ||
+ | * '' | ||
+ | * '' | ||
+ | * '' | ||
+ | |||
+ | === Gantt-Diagramme === | ||
+ | < | ||
+ | < | ||
+ | gantt | ||
+ | title Projektplan | ||
+ | dateFormat | ||
+ | section Planung | ||
+ | Anforderungen sammeln :done, des1, 2024-01-01, | ||
+ | System-Design | ||
+ | section Entwicklung | ||
+ | Frontend entwickeln | ||
+ | Backend entwickeln | ||
+ | section Tests | ||
+ | Unit Tests : | ||
+ | Integration Tests : | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | === Klassendiagramme === | ||
+ | < | ||
+ | < | ||
+ | classDiagram | ||
+ | class Fahrzeug { | ||
+ | +String marke | ||
+ | +String modell | ||
+ | +int baujahr | ||
+ | +starten() | ||
+ | +stoppen() | ||
+ | } | ||
+ | | ||
+ | class Auto { | ||
+ | +int anzahlTueren | ||
+ | +boolean automatik | ||
+ | +fahren() | ||
+ | } | ||
+ | | ||
+ | class Motorrad { | ||
+ | +String motortyp | ||
+ | +beschleunigen() | ||
+ | } | ||
+ | | ||
+ | Fahrzeug <|-- Auto | ||
+ | Fahrzeug <|-- Motorrad | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | === Git-Graphen === | ||
+ | < | ||
+ | < | ||
+ | gitGraph | ||
+ | commit id: " | ||
+ | branch develop | ||
+ | checkout develop | ||
+ | commit id: " | ||
+ | commit id: " | ||
+ | checkout main | ||
+ | commit id: " | ||
+ | merge develop | ||
+ | commit id: " | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | === User Journey Diagramme === | ||
+ | < | ||
+ | < | ||
+ | journey | ||
+ | title Benutzer-Journey: | ||
+ | section Suche | ||
+ | Webseite besuchen: 5: Benutzer | ||
+ | Produkt suchen: 3: Benutzer | ||
+ | Ergebnisse filtern: 4: Benutzer | ||
+ | section Kauf | ||
+ | Produkt auswählen: 5: Benutzer | ||
+ | In Warenkorb legen: 5: Benutzer | ||
+ | Checkout: 3: Benutzer | ||
+ | Bezahlung: 2: Benutzer | ||
+ | section Lieferung | ||
+ | Bestellung bestätigen: | ||
+ | Lieferung verfolgen: 4: Benutzer | ||
+ | Produkt erhalten: 5: Benutzer | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | === Entity-Relationship Diagramme === | ||
+ | < | ||
+ | < | ||
+ | erDiagram | ||
+ | KUNDE ||--o{ BESTELLUNG : " | ||
+ | BESTELLUNG ||--|{ BESTELLPOSITION : " | ||
+ | BESTELLPOSITION }o--|| PRODUKT : " | ||
+ | PRODUKT }o--|| KATEGORIE : " | ||
+ | | ||
+ | KUNDE { | ||
+ | int kunde_id | ||
+ | string name | ||
+ | string email | ||
+ | string adresse | ||
+ | } | ||
+ | | ||
+ | BESTELLUNG { | ||
+ | int bestellung_id | ||
+ | int kunde_id | ||
+ | date bestelldatum | ||
+ | decimal gesamtbetrag | ||
+ | } | ||
+ | | ||
+ | PRODUKT { | ||
+ | int produkt_id | ||
+ | string name | ||
+ | decimal preis | ||
+ | int kategorie_id | ||
+ | } | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | === Tortendiagramme === | ||
+ | < | ||
+ | < | ||
+ | pie title Marktanteile Browser 2024 | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | ==== Erweiterte Funktionen ==== | ||
+ | |||
+ | === Größenanpassung === | ||
+ | < | ||
+ | <mermaid 100% 400px> | ||
+ | graph TD | ||
+ | A[Breite: 100%] --> B[Höhe: 400px] | ||
+ | </ | ||
+ | |||
+ | <mermaid 500px 300px> | ||
+ | graph LR | ||
+ | C[Breite: 500px] --> D[Höhe: 300px] | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | **Unterstützte Einheiten: | ||
+ | * **Pixel:** '' | ||
+ | * **Prozent: | ||
+ | * **CSS-Einheiten: | ||
+ | |||
+ | === Raw-Modus === | ||
+ | < | ||
+ | < | ||
+ | raw | ||
+ | graph TD | ||
+ | A(**mermaid**)--> | ||
+ | A--> | ||
+ | B--> | ||
+ | C-->D | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | **Raw-Modus Vorteile:** | ||
+ | * Keine DokuWiki-Syntax-Verarbeitung | ||
+ | * Vollständige Mermaid-Funktionalität verfügbar | ||
+ | * Vermeidet Konflikte zwischen DokuWiki und Mermaid-Syntax | ||
+ | |||
+ | === DokuWiki-Links in Mermaid === | ||
+ | < | ||
+ | < | ||
+ | graph TD | ||
+ | A[Start] --> B[" | ||
+ | B --> C[" | ||
+ | C --> D[" | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | **Link-Syntax-Regeln: | ||
+ | * **Interne Links:** '' | ||
+ | * **Externe Links:** '' | ||
+ | * **Anführungszeichen: | ||
+ | |||
+ | === Styling und Themes === | ||
+ | < | ||
+ | < | ||
+ | graph TD | ||
+ | A[Knoten A] --> B[Knoten B] | ||
+ | A --> C[Knoten C] | ||
+ | B --> D[Knoten D] | ||
+ | C --> D | ||
+ | | ||
+ | %% Styling-Definitionen | ||
+ | classDef wichtig fill:# | ||
+ | classDef normal fill:# | ||
+ | | ||
+ | class A,D wichtig | ||
+ | class B,C normal | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | **Verfügbare Themes:** | ||
+ | * **Standard: | ||
+ | * **Erweitert: | ||
+ | |||
+ | ==== Diagramm-Export ==== | ||
+ | |||
+ | === SVG-Export aktivieren === | ||
+ | **Administratoren müssen den Save-Button in der Plugin-Konfiguration aktivieren: | ||
+ | - Admin → Konfiguration → Mermaid Plugin | ||
+ | - " | ||
+ | |||
+ | === Export-Funktionalität === | ||
+ | - **Maus über Diagramm:** Save-Button erscheint | ||
+ | - **SVG-Download: | ||
+ | - **Format:** Behält exakte Darstellung bei | ||
+ | |||
+ | === Server-seitige Konvertierung === | ||
+ | **Lock-Button aktivieren für statische SVG-Einbettung: | ||
+ | - Verhindert client-seitige Konvertierung | ||
+ | - Nützlich für PDF-Export (dw2pdf Plugin) | ||
+ | - Archivierung von Seiten mit statischen Diagrammen | ||
+ | |||
+ | ==== Bekannte Probleme und Lösungen ==== | ||
+ | |||
+ | === Klammer-Konflikte === | ||
+ | **Problem: | ||
+ | |||
+ | **Lösung: | ||
+ | < | ||
+ | %% Falsch: | ||
+ | graph TD | ||
+ | A[Link] --> B[[internal: | ||
+ | |||
+ | %% Richtig: | ||
+ | graph TD | ||
+ | A[Link] --> B[" | ||
+ | </ | ||
+ | |||
+ | === Click-Events vs. DokuWiki-Links === | ||
+ | **Problem: | ||
+ | |||
+ | **Schlecht: | ||
+ | < | ||
+ | < | ||
+ | flowchart TD | ||
+ | A[Link] | ||
+ | click A " | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | **Besser:** | ||
+ | < | ||
+ | < | ||
+ | flowchart TD | ||
+ | A[" | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | === Such-Highlighting === | ||
+ | * **Problem: | ||
+ | * **Lösung: | ||
+ | * **Auswirkung: | ||
+ | |||
+ | ==== Praktische Beispiele ==== | ||
+ | |||
+ | === Systemarchitektur === | ||
+ | < | ||
+ | < | ||
+ | graph TB | ||
+ | subgraph " | ||
+ | UI[Web-Interface] | ||
+ | API[API-Gateway] | ||
+ | end | ||
+ | | ||
+ | subgraph " | ||
+ | AUTH[Authentication] | ||
+ | LOGIC[Business Logic] | ||
+ | CACHE[Redis Cache] | ||
+ | end | ||
+ | | ||
+ | subgraph " | ||
+ | PG[(PostgreSQL)] | ||
+ | MONGO[(MongoDB)] | ||
+ | end | ||
+ | | ||
+ | UI --> API | ||
+ | API --> AUTH | ||
+ | API --> LOGIC | ||
+ | LOGIC --> CACHE | ||
+ | LOGIC --> PG | ||
+ | LOGIC --> MONGO | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | === Deployment-Pipeline === | ||
+ | < | ||
+ | < | ||
+ | graph LR | ||
+ | DEV[Development] --> TEST[Testing] | ||
+ | TEST --> STAGE[Staging] | ||
+ | STAGE --> PROD[Production] | ||
+ | | ||
+ | DEV --> |Git Push| BUILD[Build] | ||
+ | BUILD --> |Unit Tests| TEST | ||
+ | TEST --> |Integration Tests| STAGE | ||
+ | STAGE --> |Manual QA| PROD | ||
+ | | ||
+ | BUILD -.-> |Artifacts| REPO[Artifact Repository] | ||
+ | REPO -.-> STAGE | ||
+ | REPO -.-> PROD | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | === Entscheidungsbaum === | ||
+ | < | ||
+ | < | ||
+ | graph TD | ||
+ | START[Problem identifiziert] --> CRITICAL{Kritisch? | ||
+ | CRITICAL -->|Ja| IMMEDIATE[Sofortige Maßnahmen] | ||
+ | CRITICAL --> | ||
+ | | ||
+ | ANALYZE --> SOLUTION{Lösung verfügbar? | ||
+ | SOLUTION -->|Ja| IMPLEMENT[Implementierung] | ||
+ | SOLUTION --> | ||
+ | | ||
+ | IMMEDIATE --> DOCUMENT[Dokumentation] | ||
+ | IMPLEMENT --> DOCUMENT | ||
+ | RESEARCH --> ANALYZE | ||
+ | | ||
+ | DOCUMENT --> REVIEW[Review & Feedback] | ||
+ | REVIEW --> CLOSE[Abschluss] | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | ==== Konfiguration ==== | ||
+ | |||
+ | === Admin-Einstellungen === | ||
+ | **Zugang:** Admin → Konfiguration → Mermaid Plugin | ||
+ | |||
+ | ^ Einstellung ^ Optionen ^ Beschreibung ^ | ||
+ | | **Version/ | ||
+ | | **Standard-Theme** | default, neutral, dark, forest, base, mc-squared | Globales Theme | | ||
+ | | **Standard-Look** | classic, handDrawn, rough | Darstellungsstil | | ||
+ | | **Log-Level** | fatal, error, warn, info, debug | Debug-Informationen | | ||
+ | | **Save-Button** | Sichtbar, Verborgen | SVG-Export-Funktionalität | | ||
+ | | **Lock-Button** | Sichtbar, Verborgen | Server-seitige Konvertierung | | ||
+ | |||
+ | === Entwickler-Einstellungen === | ||
+ | **Debug-Modus aktivieren: | ||
+ | - Log-Level auf " | ||
+ | - Browser-Entwicklertools öffnen | ||
+ | - Konsole auf Mermaid-Fehler prüfen | ||
+ | |||
+ | ==== Best Practices ==== | ||
+ | |||
+ | === Performance === | ||
+ | * **Einfache Diagramme: | ||
+ | * **Komplexe Diagramme: | ||
+ | * **Lokale Version:** Schneller als Remote-Version | ||
+ | * **Cache nutzen:** Vermeiden Sie '' | ||
+ | |||
+ | === Wartbarkeit === | ||
+ | * **Kommentare: | ||
+ | * **Struktur: | ||
+ | * **Benennung: | ||
+ | * **Dokumentation: | ||
+ | |||
+ | === Zugänglichkeit === | ||
+ | * **Alt-Text: | ||
+ | * **Kontrast: | ||
+ | * **Größe: | ||
+ | |||
+ | ==== Fehlerbehebung ==== | ||
+ | |||
+ | === Häufige Probleme === | ||
+ | |||
+ | ^ Problem ^ Ursache ^ Lösung ^ | ||
+ | | Diagramm wird nicht gerendert | PHP < 8.0 | PHP-Version upgraden | | ||
+ | | Syntax-Fehler | Ungültige Mermaid-Syntax | Syntax in Mermaid Live Editor testen | | ||
+ | | DokuWiki-Konflikte | Klammer-Probleme | Raw-Modus oder Anführungszeichen verwenden | | ||
+ | | Performance-Probleme | Zu komplexe Diagramme | Diagramm vereinfachen oder aufteilen | | ||
+ | | Export funktioniert nicht | Save-Button nicht aktiviert | Admin-Konfiguration prüfen | | ||
+ | |||
+ | === Debug-Strategien === | ||
+ | - **Mermaid Live Editor:** [[https:// | ||
+ | - **Browser-Konsole: | ||
+ | - **Schrittweise Entwicklung: | ||
+ | - **Raw-Modus: | ||
+ | |||
+ | ==== Changelog ==== | ||
+ | |||
+ | === Aktuelle Version (11.6) === | ||
+ | * **2025-06-04: | ||
+ | * **2025-03-23: | ||
+ | * **2024-10-15: | ||
+ | * **2024-02-15: | ||
+ | |||
+ | === Kompatibilität === | ||
+ | * **DokuWiki: | ||
+ | * **PHP:** 8.0+ erforderlich ⚠️ | ||
+ | * **Browser: | ||
+ | * **Plugins: | ||
+ | |||
+ | ---- | ||
+ | |||
+ | **Das Mermaid Plugin erweitert DokuWiki um professionelle Diagramm-Funktionalität. Für Updates und Probleme besuchen Sie das [[https:// | ||
+ | |||
+ | {{tag> |