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
wollen mehr können als stillhalten: ein Diagramm, das aus einer
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
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.
Plugins zeigen sich an drei Stellen, je nachdem, was sie tun:
## 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
**Block einfügen …** — dahinter verbirgt sich die Liste der Bausteine,
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]_
Du musst dir die Sorten nicht merken; es hilft nur zu wissen, dass sich
Bausteine an diesen drei Stellen zeigen können.
## Wer schaltet Bausteine frei?
Welche Bausteine es in einem Teich gibt, entscheidet der
**Teich-Admin**: In den Teich-Einstellungen unter **Plugins** lassen
sich die vom Betreiber installierten Bausteine je Teich aktivieren. In
deinem persönlichen Teich bist du selbst der Admin — wirf ruhig einen
Blick in die Sektion.
Zwei Stufen: Der **Betreiber der Instanz** installiert Plugins zentral,
und dann entscheidet jeder Teich selbst. In den **Teich-Einstellungen**
unter **Plugins** aktiviert der Teich-Admin, was der Teich nutzen soll —
in deinem persönlichen Teich bist das du. Wirf ruhig einen Blick in die
Sektion.
Und falls du dich fragst, ob so ein Baustein Unfug anstellen kann:
Bausteine laufen in Dorfteich **abgeschottet** in einem eigenen
Bereich. Sie sehen nur, was ihnen die Seite gibt, und können weder an
deinen anderen Seiten noch an deinem Konto etwas ändern.
Plugins laufen in Dorfteich **abgeschottet** in einem eigenen Bereich.
Sie sehen nur, was ihnen die Seite gibt, und können weder an deinen
anderen Seiten noch an deinem Konto etwas ändern.
## 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
Kapitel einzeln vor, und du wirst sie dort auch in Nadias Teich im
Einsatz sehen.
Kapitel einzeln vor, und du siehst sie dort auch in Nadias Teich im
Einsatz.
## Probier es aus
Öffne eine Seite im Bearbeitungsmodus und klapp **Block einfügen …**
in der Werkzeugleiste auf. Nur schauen, noch nichts einfügen: Welche
Bausteine stehen in deinem Teich bereit? Im nächsten Kapitel erfährst
du, was jeder davon kann.
Öffne die **Teich-Einstellungen** deines Teichs und schau in die
Sektion **Plugins**: Was hat dein Betreiber installiert, was davon ist
in deinem Teich schon aktiv? Aktiviere, was dich neugierig macht — im
nächsten Kapitel erfährst du, was jeder Baustein kann.
---

View File

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