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
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>
168 lines
7.5 KiB
Markdown
168 lines
7.5 KiB
Markdown
# Teich-Admin-Handbuch
|
||
|
||
_Englisches Original: [docs/manual/pond-admin-guide.md](../../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](site-admin-guide.md#plugins).)
|
||
|
||
## 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 ``), 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.
|