dorfteich/docs/de/manual/user-guide.md
Claude Fable 5 2d51a55119
All checks were successful
CD / Build and push images (push) Successful in 2m40s
CD / Deploy to Test (push) Successful in 10s
CD / Smoke tests against Test (push) Successful in 1m9s
CI / Lint, typecheck, test (push) Successful in 4m23s
CI / Build container images (push) Has been skipped
CD / Promote to Int (push) Successful in 12s
CI / Auth e2e pack (push) Successful in 6m15s
CI / Import/export fidelity gate (push) Successful in 47s
Release / Build release images and notes (push) Successful in 1m7s
Release / Release-candidate operations QA (push) Successful in 41s
Prod deploy / Deploy the released images to Prod (push) Successful in 16s
QA: wire the M13 packs into CI, document the vault import (#119)
CI runs the two new packs after the graph pack (chained, each preceded
by the login rate-limit reset): create-missing-page.spec.ts (#115) and
import-vault.spec.ts (#117/#118).

Docs: the pond-admin guide gains a full 'Import an Obsidian vault'
chapter — the three dialog choices, and what happens to folders, links
(including the duplicate-name rule: the alphabetically first vault path
wins), tags, images, and embeds, plus the limits and the all-or-nothing
semantics. The user guide explains following a link to a page that does
not exist yet. features.md gets both bullets. German mirrors updated
throughout (English stays authoritative).

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

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