From 8407bc27cd81635193448bbe1d5214554a768d1a Mon Sep 17 00:00:00 2001 From: Claude Fable 5 Date: Sat, 18 Jul 2026 14:36:48 +0200 Subject: [PATCH] =?UTF-8?q?docs(tutorial):=20chapters=2018/19=20=E2=80=94?= =?UTF-8?q?=20distinguish=20blocks,=20page=20tools,=20and=20section=20styl?= =?UTF-8?q?es?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 Claude-Session: https://claude.ai/code/session_0155v2aT8AG1kZDQEZiCLBWC --- docs/de/tutorial/18-bausteine.md | 60 +++++++++++------------ docs/de/tutorial/19-standard-bausteine.md | 59 +++++++++++----------- 2 files changed, 61 insertions(+), 58 deletions(-) diff --git a/docs/de/tutorial/18-bausteine.md b/docs/de/tutorial/18-bausteine.md index 9161d30..59c822a 100644 --- a/docs/de/tutorial/18-bausteine.md +++ b/docs/de/tutorial/18-bausteine.md @@ -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. --- diff --git a/docs/de/tutorial/19-standard-bausteine.md b/docs/de/tutorial/19-standard-bausteine.md index 4438cfe..ce6aad5 100644 --- a/docs/de/tutorial/19-standard-bausteine.md +++ b/docs/de/tutorial/19-standard-bausteine.md @@ -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. ---