docs(tutorial): chapters 18/19 — distinguish blocks, page tools, and section styles
All checks were successful
CD / Build and push images (push) Successful in 1m10s
CD / Deploy to Test (push) Successful in 9s
CD / Smoke tests against Test (push) Successful in 1m13s
CD / Promote to Int (push) Successful in 11s
CI / Lint, typecheck, test (push) Successful in 4m27s
CI / Build container images (push) Has been skipped
CI / Auth e2e pack (push) Successful in 6m34s
CI / Import/export fidelity gate (push) Successful in 49s

The manifests show only mermaid/drawio are insertable blocks; toc and
page-index are page tools in the top bar, section-styles extends the
toolbar. Chapters now describe each plugin where it actually appears.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0155v2aT8AG1kZDQEZiCLBWC
This commit is contained in:
Claude Fable 5 2026-07-18 14:36:48 +02:00
parent d159181a11
commit 8407bc27cd
2 changed files with 61 additions and 58 deletions

View File

@ -3,52 +3,52 @@
Text, Bilder, Tabellen — damit kommt man weit. Aber manche Inhalte Text, Bilder, Tabellen — damit kommt man weit. Aber manche Inhalte
wollen mehr können als stillhalten: ein Diagramm, das aus einer wollen mehr können als stillhalten: ein Diagramm, das aus einer
Beschreibung entsteht; ein Inhaltsverzeichnis, das sich selbst aktuell Beschreibung entsteht; ein Inhaltsverzeichnis, das sich selbst aktuell
hält. Dafür hat Dorfteich **Bausteine** (technisch heißen sie Plugins). hält. Dafür hat Dorfteich **Plugins** — kleine Zusatzbausteine, die dem
Editor neue Fähigkeiten geben.
## Was ein Baustein ist ## Drei Sorten von Bausteinen
Ein Baustein ist ein **besonderer Block in einer Seite**. Er steht Plugins zeigen sich an drei Stellen, je nachdem, was sie tun:
zwischen deinen Absätzen wie ein Bild — aber er hat Fähigkeiten: Er
kann etwas zeichnen, zusammenstellen oder hervorheben. Du musst dafür
nichts installieren und nichts können; wenn ein Baustein im Teich
verfügbar ist, benutzt du ihn einfach.
## Einen Baustein einfügen - **Blöcke** stehen mitten in der Seite, zwischen deinen Absätzen — wie
ein Bild, nur klüger (zum Beispiel ein Diagramm). Du fügst sie im
Bearbeitungsmodus über **Block einfügen …** in der Werkzeugleiste ein.
- **Seiten-Werkzeuge** wohnen in der Kopfleiste der Seite (das
Werkzeug-Symbol): Sie berechnen etwas über die ganze Seite oder den
Teich — etwa ein Inhaltsverzeichnis — ohne dass du etwas in den Text
einfügen musst.
- **Abschnitts-Stile** erweitern die Werkzeugleiste um besondere
Gestaltungen für ganze Absätze — farbige Info-Kästen zum Beispiel.
Im Bearbeitungsmodus findest du in der Werkzeugleiste den Punkt Du musst dir die Sorten nicht merken; es hilft nur zu wissen, dass sich
**Block einfügen …** — dahinter verbirgt sich die Liste der Bausteine, Bausteine an diesen drei Stellen zeigen können.
die in deinem Teich bereitstehen. Einen auswählen, und der Block
erscheint an der Cursor-Position. Im Lesemodus zeigt er dann sein
Ergebnis: das fertige Diagramm, das Verzeichnis, den Kasten.
_[Screenshot folgt: das „Block einfügen"-Menü in der Werkzeugleiste]_
## Wer schaltet Bausteine frei? ## Wer schaltet Bausteine frei?
Welche Bausteine es in einem Teich gibt, entscheidet der Zwei Stufen: Der **Betreiber der Instanz** installiert Plugins zentral,
**Teich-Admin**: In den Teich-Einstellungen unter **Plugins** lassen und dann entscheidet jeder Teich selbst. In den **Teich-Einstellungen**
sich die vom Betreiber installierten Bausteine je Teich aktivieren. In unter **Plugins** aktiviert der Teich-Admin, was der Teich nutzen soll —
deinem persönlichen Teich bist du selbst der Admin — wirf ruhig einen in deinem persönlichen Teich bist das du. Wirf ruhig einen Blick in die
Blick in die Sektion. Sektion.
Und falls du dich fragst, ob so ein Baustein Unfug anstellen kann: Und falls du dich fragst, ob so ein Baustein Unfug anstellen kann:
Bausteine laufen in Dorfteich **abgeschottet** in einem eigenen Plugins laufen in Dorfteich **abgeschottet** in einem eigenen Bereich.
Bereich. Sie sehen nur, was ihnen die Seite gibt, und können weder an Sie sehen nur, was ihnen die Seite gibt, und können weder an deinen
deinen anderen Seiten noch an deinem Konto etwas ändern. anderen Seiten noch an deinem Konto etwas ändern.
## Ein Blick voraus ## Ein Blick voraus
Dorfteich bringt fünf Standard-Bausteine mit — vom Diagramm-Zeichner Dorfteich bringt fünf Standard-Plugins mit — von der Diagramm-Zeichnung
bis zum automatischen Inhaltsverzeichnis. Die stellen wir im nächsten bis zum automatischen Inhaltsverzeichnis. Die stellen wir im nächsten
Kapitel einzeln vor, und du wirst sie dort auch in Nadias Teich im Kapitel einzeln vor, und du siehst sie dort auch in Nadias Teich im
Einsatz sehen. Einsatz.
## Probier es aus ## Probier es aus
Öffne eine Seite im Bearbeitungsmodus und klapp **Block einfügen …** Öffne die **Teich-Einstellungen** deines Teichs und schau in die
in der Werkzeugleiste auf. Nur schauen, noch nichts einfügen: Welche Sektion **Plugins**: Was hat dein Betreiber installiert, was davon ist
Bausteine stehen in deinem Teich bereit? Im nächsten Kapitel erfährst in deinem Teich schon aktiv? Aktiviere, was dich neugierig macht — im
du, was jeder davon kann. nächsten Kapitel erfährst du, was jeder Baustein kann.
--- ---

View File

@ -1,18 +1,19 @@
# Die Standard-Bausteine im Schaufenster # Die Standard-Bausteine im Schaufenster
Dorfteich bringt fünf Bausteine mit. Dieses Kapitel ist ein Dorfteich bringt fünf Plugins mit. Dieses Kapitel ist ein
Schaufensterbummel: je ein Blick, wofür jeder gut ist — ohne Schaufensterbummel: je ein Blick, wofür jeder Baustein gut ist — ohne
Bedienungsanleitung. (Die Diagramm-Bausteine haben eigene kleine Bedienungsanleitung. (Die beiden Diagramm-Bausteine haben eigene kleine
Welten; hier geht es nur darum, dass du weißt, was es gibt.) Welten; hier geht es nur darum, dass du weißt, was es gibt.)
## Mermaid-Diagramm — Diagramme aus Text ## Mermaid-Diagramm — Diagramme aus Text
Du beschreibst in Textform, was zusammenhängt („A führt zu B, B führt Ein **Block** für die Seitenmitte: Du beschreibst in Textform, was
zu C") — der Baustein zeichnet daraus ein sauberes Diagramm: zusammenhängt („A führt zu B, B führt zu C") — der Baustein zeichnet
Ablaufpläne, Zeitleisten, Organigramme. Ideal, wenn das Diagramm mit daraus ein sauberes Diagramm: Ablaufpläne, Zeitleisten, Organigramme.
dem Inhalt mitwachsen soll: Text ändern, Zeichnung folgt. Ideal, wenn das Diagramm mit dem Inhalt mitwachsen soll: Text ändern,
Zeichnung folgt.
In Nadias Teich zeichnet ein Mermaid-Baustein den Wochenplan auf ihrer In Nadias Teich zeichnet ein Mermaid-Block den Wochenplan auf ihrer
Seite Seite
[Marathon-Training](https://dorfteich.online/public/nadia-morgenstern/marathon-training). [Marathon-Training](https://dorfteich.online/public/nadia-morgenstern/marathon-training).
@ -32,34 +33,36 @@ skizziert.
## Inhaltsverzeichnis — lange Seiten gliedern ## Inhaltsverzeichnis — lange Seiten gliedern
Der unscheinbarste und vielleicht nützlichste: Der Baustein liest die Ein **Seiten-Werkzeug**: Es sitzt hinter dem Werkzeug-Symbol in der
**Überschriften deiner Seite** und baut daraus ein klickbares Kopfleiste, liest die Überschriften der geöffneten Seite und zeigt ein
Inhaltsverzeichnis. Schreibst du einen neuen Abschnitt, taucht er von klickbares Inhaltsverzeichnis — ohne dass du irgendetwas in den Text
selbst darin auf. Nie wieder von Hand pflegen. einbauen musst. Schreibst du einen neuen Abschnitt, ist er beim
nächsten Öffnen einfach da. Probier es auf Nadias Seite
[Konzert-Notizen](https://dorfteich.online/public/nadia-morgenstern/konzert-notizen),
die mit ihren Zwischenüberschriften genau dafür gebaut ist.
## Seitenindex — Unterseiten auflisten ## Seitenindex — den Teich auflisten
Dieser Baustein listet die **Unterseiten** der aktuellen Seite Das zweite **Seiten-Werkzeug**: eine automatisch aktuelle Liste der
automatisch auf. Perfekt für Übersichts-Seiten wie Nadias Seiten des Teichs, nach Wunsch nach Label gefiltert. Praktisch, wenn
[Musik](https://dorfteich.online/public/nadia-morgenstern/musik): Kommt die Sammlung groß wird und du eine lebende Übersicht willst, die
ein neuer Ordner dazu, steht er in der Übersicht — ohne dass jemand niemand von Hand pflegen muss.
daran denken muss.
## Hervorhebungen — Kästen mit Charakter ## Abschnitts-Stile — Kästen mit Charakter
Eine kleine Familie von Schmuck-Blöcken: **Info-Kasten**, **Warnung**, Eine kleine Familie von Gestaltungen für die Werkzeugleiste:
**Hervorhebung**, **Farbige Box**. Damit hebst du das Wichtige vom **Info-Kasten**, **Warnung**, **Hervorhebung**, **Farbige Box**. Damit
Beiläufigen ab — der Hinweis, der nicht überlesen werden soll, bekommt hebst du im Bearbeitungsmodus ganze Absätze vom Beiläufigen ab — der
einen farbigen Rahmen. Hinweis, der nicht überlesen werden soll, bekommt einen farbigen
Rahmen.
## Probier es aus ## Probier es aus
Such dir **einen** Baustein aus diesem Schaufenster aus — für den Such dir **einen** Baustein aus diesem Schaufenster aus — für den
Anfang empfehlen sich das **Inhaltsverzeichnis** (auf deiner längsten Anfang empfehlen sich das **Inhaltsverzeichnis** (öffne es über das
Seite) oder ein **Info-Kasten** — und setz ihn über **Block Werkzeug-Symbol auf deiner längsten Seite) oder ein **Info-Kasten** aus
einfügen …** auf eine deiner Seiten. Mehr als einen brauchst du heute den Abschnitts-Stilen. Mehr als einen brauchst du heute nicht; die
nicht; die anderen laufen dir wieder über den Weg, wenn du sie anderen laufen dir wieder über den Weg, wenn du sie brauchst.
brauchst.
--- ---