Umfassende DokuWiki-Syntaxreferenz für wiki.satware.com [satware AG]

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- wiki:syntax [13.06.2025 13:31] – Reveal.js Plugin Dokumentation hinzugefügt - Vollständige Syntax-Referenz mit Best Practices 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>wiki syntax dokuwiki referenz 2024}}
-----
-===== 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:** [[https://github.com/neuralyzer/dokuwiki-plugin-revealjs|neuralyzer/dokuwiki-plugin-revealjs]]
-  * **Reveal.js Version:** 3.9.2
-  * **DokuWiki Kompatibilität:** 2024-02-06b "Kaos" und früher
-  * **Lizenz:** MIT (Reveal.js Framework)
-==== Grundlegende Verwendung ====
-=== Präsentation aktivieren ===
-<code>
-~~REVEAL~~
-</code>
-**Ergebnis:** Fügt einen "Präsentation starten" Button ein. **Obligatorisch** für alle Präsentationen.
-=== Theme-Auswahl ===
-<code>
-~~REVEAL white~~
-~~REVEAL theme=sky&transition=convex&controls=1~~
-</code>
-**Verfügbare Themes:**
-  * ''black'', ''white'', ''beige'', ''blood'', ''league'', ''default''
-  * ''moon'', ''night'', ''serif'', ''simple'', ''sky'', ''solarized''
-  * ''dokuwiki'' (solarized mit DokuWiki-Hintergrundfarbe)
-==== Folien-Struktur ====
-=== Header-basierte Folien ===
-<code>
-====== 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
-</code>
-**Folien-Hierarchie:**
-  * **H1 (======):** Hauptfolien (horizontal)
-  * **H2 (=====):** Horizontale Folien
-  * **H3 (====) und tiefer:** Vertikale Folien (verschachtelt)
-=== Konfigurierbare Folien-Ebenen ===
-<code>
-~~REVEAL horizontal_slide_level=1~~
-</code>
-**horizontal_slide_level Optionen:**
-  * ''1'': H1+ horizontal, H2+ vertikal
-  * ''2'': H2+ horizontal, H3+ vertikal (Standard)
-==== Hintergrund-Gestaltung ====
-=== Einfache Hintergründe ===
-<code>
-{{background>red}}
-===== Folie mit rotem Hintergrund =====
-{{background>:wiki:dokuwiki-128.png}}
-===== Folie mit Bild-Hintergrund =====
-</code>
-=== Erweiterte Hintergrund-Optionen ===
-<code>
-{{background>orange wiki:dokuwiki-128.png 10% repeat bg-slide}}
-===== Folie mit komplexem Hintergrund =====
-</code>
-**Hintergrund-Parameter:**
-  * **Farben:** HTML-Farbnamen, Hex (''#ff0000''), RGB, HSL
-  * **Bilder:** DokuWiki-Medien ('':wiki:image.png'') oder URLs
-  * **Größe:** ''10%'', ''250px'', ''auto'', ''contain'', ''cover''
-  * **Position:** ''top'', ''bottom'', ''left'', ''right'', ''center''
-  * **Wiederholung:** ''repeat'' (Standard: no-repeat)
-  * **Übergang:** ''bg-none'', ''bg-fade'', ''bg-slide'', ''bg-convex'', ''bg-concave'', ''bg-zoom''
-==== Alternative Folien-Indikatoren ====
-=== Horizontale Folien ===
-<code>
----- orange wiki:dokuwiki-128.png 10% repeat bg-slide zoom-in fade-out slow no-footer ---->
-Folien-Inhalt hier
-<----
-</code>
-**Syntax-Elemente:**
-  * ''---->'': Neue horizontale Folie öffnen
-  * ''<----'': Folie schließen
-  * ''---->>'': Vertikaler Folien-Container öffnen
-  * ''<<----'': Vertikalen Container schließen
-=== Parameter für alternative Indikatoren ===
-<code>
----- salmon wiki:dokuwiki-128.png 10% repeat bg-slide zoom-in fade-out slow no-footer ---->
-</code>
-**Übergangs-Optionen:**
-  * **Folien-Übergang:** ''none'', ''fade'', ''slide'', ''convex'', ''concave'', ''zoom''
-  * **Richtung:** ''-in'', ''-out'' (z.B. ''zoom-in'', ''fade-out'')
-  * **Geschwindigkeit:** ''default'', ''fast'', ''slow''
-==== Fragmente (Schrittweise Anzeige) ====
-=== Inline-Fragmente ===
-<code>
-<fragment>Erscheint zuerst...</fragment>
-<fragment>...dann das hier...</fragment>
-<fragment>...und schließlich das!</fragment>
-</code>
-=== Block-Fragmente ===
-<code>
-<fragment-block>
-==== Überschrift erscheint komplett ====
-  * Listenpunkt 1
-  * Listenpunkt 2
-  * Listenpunkt 3
-</fragment-block>
-</code>
-=== Fragment-Listen ===
-<code>
-<fragment-list>
-  * Punkt 1 (erscheint einzeln)
-  * Punkt 2 (erscheint einzeln)
-  * Punkt 3 (erscheint einzeln)
-</fragment-list>
-<no-fragment-list>
-  * Alle Punkte (erscheinen zusammen)
-  * Auch bei aktivierter build_all_lists Option
-</no-fragment-list>
-</code>
-=== Fragment-Stile und Indizes ===
-<code>
-<fragment style="fade-in" index="1">Erstes Fragment</fragment>
-<fragment style="highlight-red" index="2">Zweites Fragment</fragment>
-</code>
-**Fragment-Stile:**
-  * ''fade-in'', ''fade-out'', ''fade-up'', ''fade-down''
-  * ''zoom-in'', ''zoom-out''
-  * ''highlight-red'', ''highlight-green'', ''highlight-blue''
-  * ''current-visible'', ''semi-fade-out''
-==== Sprecher-Notizen ====
-<code>
-===== Folie-Titel =====
-Sichtbarer Folien-Inhalt
-<notes>
-  * Notiz für den Sprecher
-  * Nur im Sprecher-Modus sichtbar (Taste 's')
-  * Listen sind hier nie inkrementell
-</notes>
-</code>
-**Sprecher-Modus aktivieren:** Taste ''s'' während der Präsentation drücken.
-==== Fußzeilen ====
-=== Globale Fußzeile ===
-<code>
-<wrap footer>
-Firmenlogo oder Copyright-Hinweis
-</wrap>
-====== Erste Folie ======
-Inhalt...
-</code>
-=== Fußzeile für einzelne Folien deaktivieren ===
-<code>
-{{no-footer}}
-===== Folie ohne Fußzeile =====
-{{background>:images:image1.png no-footer}}
-===== Folie mit Hintergrund ohne Fußzeile =====
----- no-footer ---->
-Alternative Folien-Syntax ohne Fußzeile
-</code>
-==== Konfigurationsoptionen ====
-=== Vollständige Parameter-Syntax ===
-<code>
-~~REVEAL theme=sky&transition=convex&controls=1&show_progress_bar=1&build_all_lists=1&show_image_borders=0&horizontal_slide_level=2&enlarge_vertical_slide_headers=0&show_slide_details=1&open_in_new_window=1&auto_slide=6000&loop=1~~
-</code>
-=== Wichtige Konfigurationsparameter ===
-^ Parameter ^ Werte ^ Beschreibung ^
-| ''theme'' | ''white'', ''black'', ''sky'', etc. | Präsentations-Theme |
-| ''transition'' | ''none'', ''fade'', ''slide'', ''convex'', ''concave'', ''zoom'' | Folien-Übergang |
-| ''controls'' | ''0'', ''1'' | Navigations-Kontrollen anzeigen |
-| ''show_progress_bar'' | ''0'', ''1'' | Fortschrittsbalken anzeigen |
-| ''build_all_lists'' | ''0'', ''1'' | Listen schrittweise aufbauen |
-| ''show_image_borders'' | ''0'', ''1'' | Bild-Rahmen anzeigen |
-| ''horizontal_slide_level'' | ''1'', ''2'' | Header-Ebene für horizontale Folien |
-| ''enlarge_vertical_slide_headers'' | ''0'', ''1'' | Vertikale Folien-Header vergrößern |
-| ''size'' | ''960x700'' | Basis-Foliengröße in Pixeln |
-| ''auto_slide'' | ''0'', ''6000'' | Automatischer Folien-Wechsel (ms) |
-| ''loop'' | ''0'', ''1'' | Präsentation wiederholen |
-==== PDF-Export ====
-=== Export-URL ===
-<code>
-Normale URL:
-http://example.com/doku.php?do=export_revealjs&id=example:page
-PDF-Export URL:
-http://example.com/doku.php?do=export_revealjs&id=example:page&print-pdf
-</code>
-=== Export-Schritte ===
-  - URL mit ''&print-pdf'' Parameter aufrufen
-  - 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:** Dunkler Text auf hellem Hintergrund oder umgekehrt
-  * **Bilder optimieren:** Nicht zu große Dateien verwenden
-=== Navigation ===
-  * **Tastatur:** Pfeiltasten für Navigation
-  * **Maus:** Klick für nächste Folie
-  * **Touch:** Wischen auf mobilen Geräten
-  * **Übersicht:** Taste ''Esc'' für Folien-Übersicht
-=== Performance ===
-  * ''%%~~NOCACHE~~%%'' für dynamische Inhalte
-  * Bilder vor Upload komprimieren
-  * Nicht zu viele Fragmente pro Folie
-=== Kompatibilität ===
-  * **Include Plugin:** Siehe Kompatibilitäts-Fix in Plugin-Dokumentation
-  * **MathJax:** Wird automatisch geladen (ignoriert DokuWiki MathJax Plugin)
-  * **Wrap Plugin:** Vollständig kompatibel
-==== Beispiel-Präsentation ====
-<code>
-~~REVEAL white~~
-====== Meine Präsentation ======
-**Untertitel hier**
-Datum und Autor
-===== Agenda =====
-  * Punkt 1
-  * Punkt 2
-  * Punkt 3
-{{background>lightblue}}
-===== Hauptteil =====
-<fragment>Erster wichtiger Punkt</fragment>
-<fragment>Zweiter wichtiger Punkt</fragment>
-<fragment-block>
-==== Detaillierte Informationen ====
-  * Detail A
-  * Detail B
-  * Detail C
-</fragment-block>
-==== Unterfolie ====
-Vertikale Navigation mit Pfeiltasten
-<notes>
-Sprecher-Notizen:
-- Punkt A erwähnen
-- Fragen stellen
-- Auf nächste Folie überleiten
-</notes>
-===== Zusammenfassung =====
-  * Wichtigste Erkenntnisse
-  * Nächste Schritte
-  * Kontakt-Informationen
-===== Vielen Dank! =====
-**Fragen?**
-{{background>:images:company-logo.png}}
-</code>
-==== Fehlerbehebung ====
-=== Häufige Probleme ===
-^ Problem ^ Lösung ^
-| Präsentation startet nicht | ''%%~~REVEAL~~%%'' am Seitenanfang hinzufügen |
-| Folien werden nicht getrennt | Header-Syntax prüfen (====== vs =====) |
-| Hintergrund wird nicht angezeigt | Bild-Pfad und Dateiformat überprüfen |
-| Fragmente funktionieren nicht | Syntax von ''<fragment>'' Tags prüfen |
-| PDF-Export fehlerhaft | Chrome/Chromium Browser verwenden |
-=== Bekannte Einschränkungen ===
-  * **PHP 7.4+ erforderlich:** Ältere Versionen nicht unterstützt
-  * **DokuWiki "Igor" Kompatibilität:** Begrenzte Unterstützung
-  * **Plugin-Konflikte:** Include Plugin benötigt Anpassung
-  * **MathJax:** Verwendet eigene MathJax-Einbindung
-=== Debug-Tipps ===
-  * Browser-Entwicklertools für JavaScript-Fehler
-  * ''%%~~NOCACHE~~%%'' für Konfigurationsänderungen
-  * Plugin-Manager für Aktivierung/Deaktivierung
-  * 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://github.com/neuralyzer/dokuwiki-plugin-revealjs|GitHub Repository]].**
-{{tag>reveal.js präsentation slideshow plugin dokuwiki}}