dorfteich/docs/de/manual/user-guide.md

# Benutzerhandbuch

_Englisches Original: [docs/manual/user-guide.md](../../manual/user-guide.md)_

Wie du dich als normales Mitglied im Dorfteich zurechtfindest. Für die
Teich-Konfiguration siehe das
[Teich-Admin-Handbuch](pond-admin-guide.md), für die Verwaltung der
Instanz das [Site-Admin-Handbuch](site-admin-guide.md).

## 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 A–Z, 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. Über Checkboxen wählst du mehrere
  Seiten aus (oder **alle auf einmal**) und stellst sie mit einem Klick
  wieder her bzw. löschst sie endgültig.

## 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 1–4),
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**, den **Favoriten-Stern**, **Verlauf** und
das **…**-Menü (Markdown kopieren/herunterladen, Export nach
Word/LibreOffice/PDF, Verschieben nach…, Löschen).

## Favoriten

Ein Klick auf den **Stern** in den Seiten-Aktionen markiert eine Seite
als Favorit — der Stern füllt sich golden, und auch das Icon der Seite
im Seitenbaum wird golden. Favoriten sind **persönlich**: Deine Sterne
gehören nur dir und sind für andere Mitglieder unsichtbar. Der Knopf
**Favoriten** neben der Ansichts-Umschaltung der Seitenleiste filtert
die Seitenliste auf deine Favoriten (kombinierbar mit dem Label-Filter).

## 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](api-guide.md) und das [MCP-Handbuch](mcp-guide.md)), **Feed-Tokens** (nur-lesend, für
Atom-Feeds nicht-öffentlicher Teiche) 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.

## Feeds (Atom)

Jeder Teich hat einen Atom-Feed seiner zuletzt angelegten und geänderten
Seiten unter `/api/v1/public/<teich>/feed.xml`, jede Seite einen Feed
ihrer Versions-Historie unter `/api/v1/public/<teich>/<seite>/feed.xml`
(Issue #149). Öffentliche Teiche liefern sie ohne Konto — öffentliche
Seiten machen den Teich-Feed für Feedreader auch per `<link>` bekannt.
Für nicht-öffentliche Teiche legst du unter _Einstellungen →
Feed-Tokens_ ein **Feed-Token** an und hängst es als `?token=dt_feed_…`
an die URL — Feed-Tokens sind nur-lesend und authentifizieren
ausschließlich Feeds, nie die API.