dorfteich/docs/de/manual/user-guide.md
Claude Fable 5 36cdd4fbca Editor: confirm snapshots with a toast; wire ui.toast for plugins (#130)
Cmd/Ctrl+S used to snapshot silently. A new app-wide ToastProvider
(components/Toast.tsx) owns a bottom-center stack — permanent polite
live region, auto-dismiss after 2.5 s, click to dismiss early, error
variant. Both snapshot paths (the keyboard chords in PageEditorPage and
the save-version TopBar button) now confirm with the version name when
there is one, and their failure alert becomes an error toast.

The plugin host capability ui.toast (declared since #74, wired
nowhere) connects to the same stack: PluginBlockScope carries the
showToast handle, plugin-block passes it into the sandbox context.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Fb2VzvcoBPHkjh8bZ6PzQn
2026-07-16 12:03:17 +02:00

8.5 KiB
Raw Blame History

Benutzerhandbuch

Englisches Original: docs/manual/user-guide.md

Wie du dich als normales Mitglied im Dorfteich zurechtfindest. Für die Teich-Konfiguration siehe das Teich-Admin-Handbuch, für die Verwaltung der Instanz das Site-Admin-Handbuch.

Registrieren und anmelden

  • Registrieren (sofern die Instanz die offene Registrierung erlaubt): Benutzername, E-Mail, Anzeigename, Passwort, Sprache. Du bestätigst deine E-Mail über den Link in der Bestätigungsmail; dabei entsteht auch dein persönlicher Teich — dein eigener Raum, den nur du siehst, bis du ihn teilst.
  • Anmelden mit Benutzername oder E-Mail. Passwort vergessen? Die Anmeldeseite hat einen Link zum Zurücksetzen (setzt voraus, dass die Instanz Mail-Versand konfiguriert hat).
  • Deine Sitzungen findest du unter Einstellungen → Aktive Sitzungen; dort kannst du jedes Gerät abmelden.

Teiche und Seiten

  • Der Teich-Umschalter in der Kopfleiste bringt dich zwischen den Teichen hin und her, die du sehen kannst — und „+ Neuer Teich" an seinem unteren Ende legt einen neuen gemeinsamen Teich an (begrenzt durch ein Kontingent, das der Site-Admin setzt). Die Seitenleiste listet die Seiten des aktuellen Teichs — sortiere sie AZ, nach Erstellungsdatum oder ziehe sie in eine manuelle Reihenfolge (der Sortiermodus ist eine Teich-Einstellung).
  • + Neue Seite am unteren Ende der Seitenleiste legt eine Seite an. Seiten-Adressen sind lesbar: /p/<teich>/<seite>.
  • Seiten bilden einen Baum. Eine Seite, die du anlegst, während eine andere geöffnet ist, wird deren Unterseite (das Formular sagt es an); Seiten verschachteln bis zu sechs Ebenen tief. Die Ordner-Ansicht der Seitenleiste zeigt den Baum mit einklappbaren Zweigen; die Label-Ansicht gruppiert die Seiten stattdessen unter dem Label-Baum. Der Umschalter über der Seitenliste gilt nur für dich — der Teich-Eigentümer legt lediglich den Standard fest. Verschieben ändert nie die Adresse einer Seite, Links bleiben also intakt.
  • Seiten verschieben: Ziehe eine Seite auf eine andere, um sie dort einzuordnen (zwischen Seiten ziehen sortiert innerhalb der Ebene um, im manuellen Sortiermodus), oder nutze … → Verschieben nach… für eine Zielauswahl, die in jedem Sortiermodus funktioniert. Beim Löschen einer Seite mit Unterseiten wirst du gefragt, was mit ihnen passieren soll: eine Ebene hochrücken oder den ganzen Teilbaum gemeinsam in den Papierkorb.
  • Der Graph-Link unten in der Seitenleiste öffnet den Wissensgraphen des Teichs: Seiten als Punkte, Wikilinks als Linien — ein Klick öffnet die Seite, Ziehen ordnet an, Scrollen zoomt. Gestrichelte Punkte sind Wikilink-Ziele, die es noch nicht gibt; ein Klick legt die Seite an. Unter jeder Seite (Lesemodus) zeigt ein lokaler Graph ihre Nachbarschaft, umschaltbar zwischen einer und zwei Ebenen.
  • Der Papierkorb-Link sitzt ganz unten in der Seitenleiste: Gelöschte Seiten lassen sich dort wiederherstellen, bis die Aufbewahrungsfrist endet. Eine wiederhergestellte Seite hängt sich an den nächsten noch vorhandenen Elternknoten, oder an die oberste Ebene, wenn der ganze Zweig fehlt.

Der Editor

Klicke auf das Stift-Symbol in der Kopfleiste, um eine Seite zwischen Lesen und Bearbeiten umzuschalten. Im Bearbeitungsmodus bietet eine Werkzeugleiste Absatz-Stile (Überschrift 14), fett/kursiv/durchgestrichen/Inline-Code, Aufzählungs-, nummerierte und Aufgabenlisten, Zitate, Code-Blöcke, Trennlinien, Bilder und Tabellen. Die Werkzeugleiste bleibt beim Scrollen sichtbar.

  • Alle bearbeiten gemeinsam. Andere Personen auf der Seite erscheinen in der Anwesenheitsleiste in der Kopfleiste und als benannte Cursor im Text. Es gibt keinen Speichern-Knopf für den Inhalt — jeder Tastendruck wird gespeichert und live repliziert.
  • Offline? Das Status-Symbol in der Fußzeile (unten links) zeigt deine Verbindung. Du kannst offline weitertippen; die Änderungen synchronisieren sich beim Wiederverbinden.
  • Markdown rein, Markdown raus. Du kannst Markdown einfügen oder tippen; die Seite lässt sich jederzeit wieder als Markdown kopieren oder herunterladen (-Menü → Als Markdown kopieren/herunterladen).
  • Wikilinks: Tippe [[seiten-slug]] oder [[seiten-slug|angezeigter Text]]. Links auf Seiten, die es noch nicht gibt, listet die Teich-Startseite unter „Fehlende Seiten" — ein Klick legt das Ziel an. Genauso kannst du einem solchen Link einfach folgen: Die Seite öffnet sich mit dem Hinweis, dass es sie noch nicht gibt, und einem Knopf, der sie direkt dort anlegt — danach funktionieren alle Links auf diese Adresse. Das Panel „Verlinkt von" einer Seite zeigt jede Seite, die auf sie verweist.
  • Bilder und Anhänge: Füge Bilder direkt per Einfügen oder Ziehen in den Text ein. Andere Dateitypen (PDFs usw., soweit die Instanz sie erlaubt) hängst du über das Büroklammer-Symbol an die Seite.
  • Benannte Versionen: Das Speichern-Symbol im Bearbeitungsmodus legt einen benannten Schnappschuss an („vor dem großen Umbau"); Strg/Cmd+S speichert einen unbenannten, Strg/Cmd+Shift+S fragt nach einem Namen — ein kurzer Toast bestätigt jedes Speichern. Das Verlauf-Symbol listet alle Versionen — automatische und benannte — mit ihren Mitwirkenden; du kannst jede Version ansehen und wiederherstellen. Wiederherstellen löscht nie den Verlauf.

Die Seiten-Aktionen in der Kopfleiste

Bei geöffneter Seite findest du neben dem Stift: Beobachten (Glocke für diese Seite), Kommentare (mit Zähler für Ungelesenes), Anhänge, Seiten-Werkzeuge (Inhaltsverzeichnis, Seitenindex — sofern aktiviert), Labels, Verlauf und das -Menü (Markdown kopieren/herunterladen, Export nach Word/LibreOffice/PDF, Verschieben nach…, Löschen).

Labels

Öffne das Label-Symbol, um die Seite zu verschlagworten. Du kannst bestehende Labels wählen oder direkt ein neues anlegen (das Anlegen ist Teich-Admins vorbehalten). Labels ordnen Seiten und können Zugriffsregeln tragen — eine Seite erbt jede Regel ihrer Labels.

Suche

Das Suchfeld in der Kopfleiste durchsucht jede Seite, die du lesen darfst, über alle Teiche hinweg — tolerant gegenüber Akzenten („Baume" findet „Bäume") und Teilwörtern. Letzte Suchen werden gemerkt (und lassen sich löschen).

Kommentare

Das Sprechblasen-Symbol öffnet das Kommentar-Panel: Threads mit einer Antwort-Ebene, Markdown möglich, Bearbeiten und Löschen für eigene Kommentare, Erledigen klappt abgeschlossene Diskussionen weg. Ob alle Lesenden oder nur Bearbeitende kommentieren dürfen, ist eine Teich-Einstellung.

Beobachten, Benachrichtigungen, Digests

  • Beobachte eine Seite (Glocke in den Seiten-Aktionen) oder einen ganzen Teich (Glocke im Kopf der Teich-Einstellungen), um über Änderungen und Kommentare benachrichtigt zu werden. Standardmäßig beobachtest du automatisch Seiten, die du anlegst oder kommentierst — beide Schalter liegen unter Einstellungen → Profil.
  • Die Glocke in der Kopfleiste ist dein Benachrichtigungs-Posteingang; Einträge verlinken direkt auf die Änderung (Kommentar-Benachrichtigungen öffnen das Panel).
  • E-Mail-Digests bündeln ungelesene Benachrichtigungen stündlich oder täglich — einstellbar unter Einstellungen, abbestellbar direkt aus jeder Digest-Mail.

Import und Export

  • Dokument importieren (Link in der Seitenleiste): .docx, .odt oder .md wird zu einer neuen Seite, eingebettete Bilder inklusive.
  • Seite exportieren: „…"-Menü → Markdown / Word / LibreOffice / PDF. Teich exportieren: Teich-Einstellungen → ZIP aller Seiten, die du lesen darfst, als Markdown plus Medien.

Deine Einstellungen (oben rechts → Einstellungen)

Profil (Anzeigename, E-Mail, Sprache, Beobachten-Voreinstellungen, Digest-Frequenz), Passwort, aktive Sitzungen, deine beobachteten Seiten und Teiche, API-Tokens (für Skripte und KI-Assistenten — siehe das API-Handbuch und das MCP-Handbuch) und Meine Daten exportieren: ein ZIP mit deinen Profildaten und dem vollständigen Inhalt deiner eigenen Teiche.

Öffentliche Seiten

Hat ein Teich-Admin eine Seite öffentlich geschaltet, ist sie ohne Konto unter /public/<teich>/<seite> lesbar — mit der Typografie des Teichs und einem Link auf die Rechtsseiten der Instanz.