From 6945cd07248b87389af99d153cc45395f716eea1 Mon Sep 17 00:00:00 2001 From: Claude Fable 5 Date: Sat, 18 Jul 2026 14:26:07 +0200 Subject: [PATCH] =?UTF-8?q?docs:=20site-admin=20guide=20=E2=80=94=20where?= =?UTF-8?q?=20reference=20plugin=20ZIPs=20come=20from=20+=20rollout=20step?= =?UTF-8?q?s?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Fable 5 Claude-Session: https://claude.ai/code/session_0155v2aT8AG1kZDQEZiCLBWC --- docs/de/manual/site-admin-guide.md | 19 +++++++++++++++++++ docs/manual/site-admin-guide.md | 17 +++++++++++++++++ 2 files changed, 36 insertions(+) diff --git a/docs/de/manual/site-admin-guide.md b/docs/de/manual/site-admin-guide.md index 0b7b013..4cb7e43 100644 --- a/docs/de/manual/site-admin-guide.md +++ b/docs/de/manual/site-admin-guide.md @@ -99,6 +99,25 @@ Mitgelieferte Referenz-Plugins: `toc` (Inhaltsverzeichnis), (Diagramm-Blöcke), `drawio` (vollwertiges draw.io-Bearbeiten), `section-styles-basic` (farbige Hinweiskästen). +**Woher kommen die ZIPs der Referenz-Plugins?** Sie liegen den +Server-Images nicht bei — sie werden aus dem Repository gebaut (Node 22 + +- pnpm, einmalig `pnpm install` im Repo-Wurzelverzeichnis): + +```sh +cd packages/plugins/ # toc | page-index | mermaid | drawio | section-styles-basic +pnpm build # → dist/-.zip — diese Datei hochladen +``` + +Der `drawio`-Build lädt beim ersten Lauf sein gepinntes Editor-Bundle +von GitHub und packt ein ~27-MiB-ZIP (innerhalb des 64-MiB-Limits für +Plugin-Uploads); die anderen vier bauen offline in Sekunden. + +**Typischer Ablauf:** ZIP hochladen, die abgeschottete Vorschau prüfen, +den Instanz-Modus auf `optional` stellen und das Plugin dann je Teich +aktivieren (Teich-Einstellungen → **Plugins** — in persönlichen Teichen +macht das der Eigentümer selbst). + ### Personen Die Personenverwaltung: Konten suchen, deaktivieren/aktivieren, diff --git a/docs/manual/site-admin-guide.md b/docs/manual/site-admin-guide.md index 5837dcd..b2a2bf6 100644 --- a/docs/manual/site-admin-guide.md +++ b/docs/manual/site-admin-guide.md @@ -90,6 +90,23 @@ Shipped reference plugins: `toc` (table of contents), `page-index` (label-filtered page list), `mermaid` (diagram blocks), `drawio` (full draw.io editing), `section-styles-basic` (colored callouts). +**Getting the reference plugin ZIPs.** They are not bundled with the +server images — build them from the repository (Node 22 + pnpm, one-time +`pnpm install` at the repo root): + +```sh +cd packages/plugins/ # toc | page-index | mermaid | drawio | section-styles-basic +pnpm build # → dist/-.zip — upload that file +``` + +The `drawio` build downloads its pinned editor bundle from GitHub on the +first run and packs a ~27 MiB ZIP (within the 64 MiB plugin upload +limit); the other four build offline in seconds. + +**Typical rollout:** upload the ZIP, check the sandboxed preview, switch +the instance mode to `optional`, then enable the plugin per pond (pond +settings → **Plugins** — in personal ponds the owner does this). + ### Users The user manager: search accounts, disable/enable, resend verification