# 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>`.
- Der **Papierkorb**-Link sitzt ganz unten in der Seitenleiste:
  Gelöschte Seiten lassen sich dort wiederherstellen, bis die
  Aufbewahrungsfrist endet.

## 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. 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, 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](api-guide.md) und das [MCP-Handbuch](mcp-guide.md)) 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.