dorfteich/docs/de/manual/pond-admin-guide.md

Teich-Admin-Handbuch

Englisches Original: docs/manual/pond-admin-guide.md

Was du an einem Teich konfigurieren kannst, den du verwaltest. Teich-Admin bist du auf deinem persönlichen Teich und auf jedem Teich, auf dem du die Rolle pond_admin hast. All das liegt hinter dem Zahnrad-Symbol in der Kopfleiste (sichtbar auf Teich-Routen, wenn du den Teich verändern darfst).

Teiche in einer Minute

Jedes Mitglied bekommt automatisch einen persönlichen Teich. Zusätzliche gemeinsame Teiche legst du über „+ Neuer Teich" am unteren Ende des Teich-Umschalters in der Kopfleiste an (oder über die API, POST /api/v1/ponds); sie unterliegen dem Pro-Person-Kontingent des Site-Admins („Zusätzliche geteilte Teiche pro Person", Standard 0). Wer den Teich anlegt, wird sein Teich-Admin.

Name, Beschreibung, Darstellung

• Name und Beschreibung des Teichs.
• Schriften: Wähle pro Teich Schriften für Überschriften, Fließtext und Code aus dem eingebauten, selbst gehosteten Katalog (stöbern unter /fonts) — sie gelten für die App-Ansicht, öffentliche Seiten und PDF-Exporte.
• Seitenleisten-Sortierung für alle: A–Z, Erstellungsdatum oder manuelle Reihenfolge.
• Seitenleisten-Ansicht als Standard: der Seitenbaum („Ordner") oder Seiten gruppiert unter dem Label-Baum. Mitglieder können ihre eigene Seitenleiste weiterhin lokal umschalten — die Einstellung bestimmt nur den Ausgangspunkt.

Mitglieder und Rollen

Der Abschnitt Mitglieder verwaltet, wer im Teich ist:

Rolle	Darf
reader	Seiten lesen (soweit die Regeln es erlauben)
editor	Seiten lesen + schreiben, Dateien hochladen
pond_admin	alles, einschließlich Einstellungen, Mitglieder und Labels

Die Mitgliederzahl begrenzen die Instanz-Kontingente (Bearbeiter/Leser pro Teich). Auch persönliche Teiche nehmen Mitglieder auf — genau so teilst du deinen.

Zugriffsregeln (das Kleingedruckte)

Über die reine Mitgliedschaft hinaus bearbeitet der Abschnitt Zugriffsregeln die Berechtigungen direkt. Eine Regel besteht aus: Subjekt (eine Person, alle Angemeldeten oder die Öffentlichkeit) + Recht (Leser/Bearbeiter/Teich-Admin) + Geltungsbereich (ganzer Teich, ein Label oder eine Seite) + Wirkung (erlauben oder verbieten).

• Label-Regeln sind das Power-Tool: Gib den vertraulichen Seiten das Label „Vorstand" und erlaube nur den Vorstandsmitgliedern dieses Label — oder verbiete ein Label jemandem, der sonst alles lesen darf.
• Öffentliche Seiten: Eine Erlauben, Leser, öffentlich-Regel auf einer Seite (oder einem Label) veröffentlicht sie schreibgeschützt unter /public/<teich>/<seite>.
• Verbieten schlägt Erlauben; verweigertes Lesen sieht aus wie „nicht gefunden" (das System verrät nie, was existiert).
• Der Inspektor „Effektive Rechte" auf einer Seite erklärt das wirksame Ergebnis für jede Person — nutze ihn immer, wenn dich eine Regel-Kombination überrascht.

Labels

Verwalte den Label-Baum des Teichs (anlegen, umbenennen, umfärben, verschachteln, verschieben, löschen). Das Löschen eines Labels, das noch auf Seiten liegt, fragt nach. Labels erscheinen auch im Label-Wähler der Seiten; dort ist das Anlegen neuer Labels dir vorbehalten.

Kommentar-Richtlinie

Wähle, ob alle mit Lesezugriff kommentieren dürfen oder nur Bearbeitende. Bestehende Kommentare bleiben so oder so lesbar.

Den Teich beobachten

Die Glocke im Kopf der Teich-Einstellungen beobachtet den ganzen Teich — du wirst über jede Seitenänderung und jeden Kommentar darin benachrichtigt.

Plugins

Plugins, die der Site-Admin mit Modus Optional installiert hat, erscheinen hier mit einem Schalter pro Teich. Erforderliche Plugins sind immer aktiv; deaktivierte tauchen gar nicht auf. (Welche Plugins es gibt und was sie tun: Site-Admin-Handbuch.)

Maschinenzugriff: API- und MCP-Freigabe

Zwei getrennte Schalter geben diesen Teich für Token-Zugriff frei — beide standardmäßig aus, und beide nur wirksam, wenn der Site-Admin den passenden Instanz-Schalter aktiviert hat:

• Öffentliche REST-API (apiEnabled): Skripte und Integrationen erreichen den Teich mit persönlichen API-Tokens — mit exakt den Berechtigungen der Token-Besitzerin.
• MCP / KI-Assistenten (mcpEnabled): MCP-Clients wie Claude Code erreichen den Teich auf demselben Weg.

Ein Teich ohne Freigabe ist über diese Schnittstellen unsichtbar — selbst für die Tokens der eigenen Mitglieder.

Obsidian-Vault importieren

Teich-Einstellungen → Obsidian-Vault importieren nimmt ein ZIP eines ganzen Vaults und macht Seiten daraus. Du wählst drei Dinge:

• Einhängen unter — die Seite, unter der der Vault landet (oder die oberste Ebene).
• Zusätzliche Labels — bekommt jede importierte Seite, zusätzlich zu den Labels aus den Tags des Vaults.
• YAML-Frontmatter — entfernen oder als Code-Block am Seitenanfang behalten.

Was mit dem Vault passiert:

• Ordner werden Seiten. Jeder Ordner wird eine Container-Seite, die Notizen hängen darunter — die Vault-Struktur bleibt erhalten. Seiten verschachteln höchstens sechs Ebenen tief; ist der Vault (samt Einhänge-Tiefe) tiefer, werden die untersten Ordner-Ebenen zu einer Seite mit Titel so/zusammengelegt.
• [[Wikilinks]] funktionieren weiter. Obsidian-Links zeigen auf Notiz-Namen, Dorfteich-Links auf Seiten-Adressen — jeder Link wird deshalb auf die Adresse umgeschrieben, die die Notiz tatsächlich bekommen hat: [[Notiz|Anzeigetext]], [[Notiz#Überschrift]] (der Überschriften-Teil entfällt) und [[Ordner/Notiz]] inklusive. Links auf Notizen, die es im Vault nicht gibt, werden zu Links auf fehlende Seiten — genau wie selbst getippt. Tragen zwei Notizen in verschiedenen Ordnern denselben Namen, zeigt ein einfaches [[Name]] auf die, deren Vault-Pfad alphabetisch zuerst kommt.
• Tags werden Labels. Sowohl tags: im Frontmatter als auch #Tags im Text (die dabei aus dem Text verschwinden). Verschachtelte Tags wie #status/aktiv werden zu einer Label-Hierarchie.
• Bilder und Dateien kommen mit. Bilder, auf die eine Notiz verweist (![[bild.png]] oder ![](media/bild.png)), werden zu Teich-Dateien und erscheinen in der Seite; andere erlaubte Dateitypen werden Anhänge. Sie zählen gegen das Speicher-Kontingent des Teichs. ![[Andere Notiz]]-Einbettungen werden zu normalen Links (Dorfteich bettet keine Seiten ineinander ein).

Grenzen: Das ZIP darf bis zu 64 MiB groß sein, entpackt bis 256 MiB. Ein Import ist Alles-oder-nichts — schlägt etwas fehl (voller Teich, kaputtes Archiv), bleibt nichts zurück und du kannst es einfach erneut versuchen.

Dateien

Die Dateiverwaltung listet die Uploads des Teichs mit ihrer Verwendung (welche Seite sie referenziert) und lässt dich verwaiste Dateien löschen. Der Speicher zählt gegen das Kontingent des Teichs; die aktuelle Nutzung wird angezeigt.

Export und Löschung

• Export: der ganze Teich als ZIP aus Markdown-Dateien plus Medien.
• Teich löschen: Die Gefahren-Sektion am Ende der Teich-Einstellungen verschiebt einen gemeinsamen Teich in den Instanz-Papierkorb (zur Bestätigung den Teichnamen eintippen); ein Site-Admin kann ihn wiederherstellen. Dein persönlicher Teich lässt sich nicht löschen — er ist das Zuhause deines Kontos.