37 lines
1.4 KiB
Markdown
37 lines
1.4 KiB
Markdown
# IMS Management Cockpit
|
|
|
|
Offline nutzbares HTML-Cockpit zur Navigation und Einsicht aller IMS-Dokumente.
|
|
|
|
## Nutzen
|
|
|
|
`IMS-Cockpit.html` per Doppelklick im Browser öffnen. Es enthält alle IMS-Dokumente
|
|
gerendert (Markdown -> HTML), einen Navigationsbaum nach ISO-Kapitel, Volltextsuche,
|
|
ein Dashboard (Dokumentenzahl, Status, überfällige Reviews) und eine Pendenzen-Seite
|
|
(Massnahmenregister + überfällige Reviews + `[ZU PRÜFEN]`-Marker). Mermaid-Diagramme
|
|
sind eingebettet und werden offline gerendert. Keine Internetverbindung nötig.
|
|
|
|
## Neu generieren (nach Doku-Änderungen)
|
|
|
|
```bash
|
|
python build_cockpit.py
|
|
```
|
|
|
|
Das aktualisiert `IMS-Cockpit.html`. Beim ersten Lauf wird `mermaid.min.js` einmalig
|
|
vom CDN geladen und unter `_vendor/` zwischengespeichert; danach läuft der Build offline.
|
|
|
|
## Hintergrund (technisch)
|
|
|
|
Browser blockieren `fetch()` lokaler Dateien unter `file://`. Deshalb wird der gerenderte
|
|
Inhalt zur Build-Zeit in die HTML eingebettet (eine portable Datei, Mermaid inline) -- so
|
|
genügt ein Doppelklick. Der Generator hat keine externen Python-Abhängigkeiten.
|
|
|
|
## Automatisierung (optional)
|
|
|
|
`python build_cockpit.py` kann als Forgejo-CI-Schritt oder Pre-Commit-Hook laufen, damit
|
|
das Cockpit bei jeder Doku-Änderung automatisch aktuell bleibt.
|
|
|
|
## Dateien
|
|
|
|
- `build_cockpit.py` -- Generator
|
|
- `IMS-Cockpit.html` -- generierte Cockpit-Datei (Doppelklick)
|
|
- `_vendor/mermaid.min.js` -- lokal zwischengespeicherte Mermaid-Bibliothek
|