km/docs/quellen.md

Quellen — fremde Git-Repos als Checkout in der Ablage

Festlegung Andreas, 2026-09-04: die info-Doku kommt als zweite Quelle in km — vorerst komplett, ohne Filter nach Klassifikation. „Sobald hive.corp steht, trennen wir die Quellen." Konfiguration KM_SOURCES, Code in gitrepo.py (sources_of) und runner.py.

Bauform

Jede Quelle ist ein eigener Git-Checkout in der Ablage:

<ablage>/<ns>/doku/<name>/     ← z. B. familie/doku/info/ = Clone von ahmann/info

• SilverBullet sieht die Seiten wie alle anderen; der Index nimmt sie mit (typ: doku, projekt: <name>, classification aus dem Frontmatter).
• Die Ablage ignoriert */doku/ in ihrer .gitignore: die Wahrheit dieser Seiten liegt im Quell-Repo, nicht ein zweites Mal in ahmann/km.
• Je Takt: Änderungen aus der Oberfläche werden im Checkout committet („km: Änderungen aus der Oberfläche", Autor KM_GIT_NAME) und in das Quell-Repo gepusht, danach git pull --rebase. Ein Commit aus SilverBullet landet also Minuten später auf master von ahmann/info — ohne PR und ohne Umlaut-Riegel. Das ist gewollt (Auto-Commit und Push).

Konfiguration

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 getrennt werden, ist die Familien-Oberfläche damit nicht nur Familie.
• Admonitions (!!! warning) aus MkDocs zeigt SilverBullet als Rohtext (Test vom 04.09., spine/core#8).
• Der Checkout enthält das ganze Repo (ai/, deployment/, …), nicht nur docs/; indexiert werden nur *.md.