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
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:
parent
d159181a11
commit
8407bc27cd
@ -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.
|
||||
|
||||
---
|
||||
|
||||
|
||||
@ -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.
|
||||
|
||||
---
|
||||
|
||||
|
||||
Loading…
Reference in New Issue
Block a user