Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
| Beide Seiten der vorigen Revision Vorhergehende Überarbeitung Nächste Überarbeitung | Vorhergehende Überarbeitung | ||
| wiki:syntax [02.07.2025 05:40] – Mermaid Plugin Syntax-Dokumentation hinzugefügt Jane Alesi | wiki:syntax [15.10.2025 05:34] (aktuell) – alte Version wiederhergestellt (10.06.2025 10:42) Michael Wegener | ||
|---|---|---|---|
| Zeile 766: | 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> | ||