DW-Editor: Formatierung
Zurück: Editoren und Code-Darstellung
Welcher Knopf in der Editor-Werkzeugleiste welches Syntaxzeichen setzt – für Markdown-Seiten und für DokuWiki-Seiten getrennt, denn die Leisten sind nicht dieselben.
1. Übersicht und Zweck
Status: [Live] – dokumentiert die Syntax-Token-Zuordnung der
vorhandenen Editor-Toolbars (EasyMDE für Markdown-Seiten, Core-Toolbar für
DokuWiki-Syntax-Seiten; Umschaltung s.
editors → Umschaltung).
Referenz für die
Kategorien-Auswahl (nicht für das Zielformat!): DevExpress
ASPxHtmlEditor (https://demos.devexpress.com/ASPxHTMLEditorDemos/Default.aspx)
– die dort gezeigten HTML-Tags gelten nicht für diese Bibliothek.
2. Voraussetzungen
Editor ↔ Markup- Umschaltung bereits verstanden.
3. Konzepte
Warum kein HTML: der Editor bearbeitet Wiki-Quelltext, kein HTML –
dieselbe Leitplanke wie in den
Grundlagen: Markup bleibt
Speicherformat, WYSIWYG ist nur eine Ansicht darauf. Ein
Formatierungsbefehl fügt deshalb nie <b>/<i>-Tags ein,
sondern den passenden Syntax-Token – DokuWikis eigener Renderer (bzw.
wvdsdwmds ParsedownRenderer bei Markdown-Seiten) übernimmt danach
die HTML-Erzeugung.
4. Erste Schritte
Jeder Befehl schreibt DokuWiki-Syntax oder Markdown, je nach Speicherformat der bearbeiteten Seite (Marker-Autodetect entscheidet, welches Format eine Seite hat) – kein manueller Formatwahl-Schritt nötig.
5. Verwendung
Für Zeichenformate (Fett/Kursiv/…) Abschnitt 6, für Absatzformate (Überschriften/Listen/…) Abschnitt 7.
6. API-Referenz: Zeichenformate
| Toolbar-Befehl | DokuWiki-Syntax | Markdown |
|---|---|---|
| Fett | **Text** | **Text** |
| Kursiv | //Text// | _Text_ |
| Unterstrichen | __Text__ | kein natives Markdown-Äquivalent – Befehl bleibt deaktiviert auf Markdown-Seiten (kein HTML-Ausweich, s. Abschnitt 3) |
| Durchgestrichen | <del>Text</del> | ~~Text~~ |
| Monospace (inline) | ''Text'' | `Text` |
| Hochgestellt/Tiefgestellt | <sup>Text</sup>/<sub>Text</sub> | kein natives Äquivalent – deaktiviert |
7. Parameter, Optionen und Zustände: Absatzformate
| Toolbar-Befehl | DokuWiki-Syntax | Markdown |
|---|---|---|
| Überschrift 1–5 | ====== … ====== … == … == (Ebene = Anzahl =) | # … … ##### … |
| Ungeordnete Liste | * Eintrag (zwei Leerzeichen + Stern, eine physische Zeile je Eintrag – s. Abschnitt 9) | - Eintrag |
| Geordnete Liste | - Eintrag | 1. Eintrag |
| Zitat/Blockquote | > Text | > Text |
| Codeblock | <code lang>…</code> | ```lang … ``` (Fenced Code Block) |
8. Vollständige Beispiele
Entfällt – reine Token-Referenztabelle, kein ausführbares Beispiel.
9. Einschränkungen und Randfälle
Falle: Listen-Zeilenumbruch. Ein WYSIWYG-Editor, der einen langen
Listeneintrag automatisch visuell umbricht, darf beim Zurückserialisieren
keinen echten Zeilenumbruch in den DokuWiki-Quelltext schreiben – ein
Listeneintrag muss eine einzige physische Quelltextzeile bleiben, sonst
fällt er beim nächsten Rendern aus der Liste und erscheint als rohes
<pre> (dieselbe Falle, die bei mehreren Unterseiten dieser
Doku-Runde von Hand korrigiert wurde – hier als Spezifikationsanforderung
an einen künftigen Editor festgehalten, nicht nur als Autoren-Fehler).
10. Accessibility und Kompatibilität
Vollständiger Überblick: Accessibility.
11. Troubleshooting
Entfällt.
12. Verwandte Themen
- Editoren und Code-Darstellung – Grundlagen und WYSIWYG-Vertrag
- DW-Editor: Tabellen und Medien – Tabellen-/Medien-/Link-Syntax
- Markdown (wvdsmd) – Markdown-Fluss, Marker-Autodetect