Beschreibe den Doku-Leseweg über die gebaute MkDocs-Seite

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-04 20:03:07 +02:00
parent 125a8b9c0f
commit a8704fcddd
2 changed files with 19 additions and 0 deletions
@@ -32,6 +32,14 @@ KM_SOURCES=info=https://git.home/ahmann/info.git@master
 `name=url[@branch]`, mehrere durch Komma. Zugang: dieselben `KM_GIT_USER`/
 `KM_GIT_PASSWORD` wie für die Ablage; die `.netrc` bekommt jeden Remote-Host.

+## Lesen: statische Seite
+
+Hat die Quelle ein `mkdocs.yml`, baut km sie nach jedem Pull mit Änderung
+mit `python -m mkdocs build` nach `<data>/site/<name>` — die gewohnte
+MkDocs-Darstellung, read-only, ohne laufenden Dienst. Caddy liefert sie unter
+`/doku/<name>/` aus (deploy/README.md). SilverBullet bleibt für die Ablage
+selbst; für die Doku ist die gebaute Seite der Leseweg.
+
 ## Was Andreas wissen sollte

 - **Alles ist drin**, auch `corp`- und `lan`-Seiten — bis die Quellen