dorfteich/docs/de/manual/user-guide.md
Claude Fable 5 14711a18c2
All checks were successful
CD / Build and push images (push) Successful in 1m9s
CD / Deploy to Test (push) Successful in 10s
CD / Smoke tests against Test (push) Successful in 1m12s
CD / Promote to Int (push) Successful in 10s
CI / Lint, typecheck, test (push) Successful in 4m18s
CI / Build container images (push) Has been skipped
CI / Auth e2e pack (push) Successful in 5m59s
CI / Import/export fidelity gate (push) Successful in 47s
QA: page-tree and graph e2e packs in CI, manuals updated (#114)
Two new CI-wired Playwright packs, each in its own shared pond so the
fixture ponds stay untouched:

- page-tree.spec.ts — create-as-child with the form hint, collapsible
  folder view (collapse state survives reload), label view grouping,
  the local view override vs the owner-set pond default (fresh context
  without localStorage sees the new default), the Move-to dialog with
  the own subtree disabled, promote vs subtree delete, and a restored
  orphan re-attaching at the root.
- graph.spec.ts — pond graph nodes/edges/legend, node click-through,
  the phantom-create flow (dashed node turns solid), the local panel
  with hop toggle and highlight ring, and the permission slice: a
  label-denied reader sees neither the hidden node nor its edge.

Both packs 3× flake-free locally. Manuals: user guide (page tree,
moving/deleting with subpages, knowledge graph + local graph), pond
admin guide (sidebar view default), features.md (knowledge graph
bullet) — with the docs/de mirrors updated (English authoritative).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-14 11:10:14 +02:00

8.1 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. 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"). 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.