Prozesse Wiki - Entwicklung¶
Mint System Wiki lokal entwickeln¶
Die Webseite https://wiki.mint-system.ch wird mit Zensical gebaut. Zensical liest die Markdown-Dateien im Ordner docs und erzeugt daraus eine statische Webseite. Die Wiki-Markdown-Dateien liegen im GitHub Repository und werden mit ./task prepare-docs in den Ordner docs konvertiert.
Arbeitsschritte:
- Klonen Sie das Repository
- Initialisieren Sie das Zensical Projekt
Voraussetzungen sind uv und Node.js. Das Kommando erstellt die Python-Umgebung .venv, installiert Zensical und legt die Konfiguration in zensical.toml an (falls noch nicht vorhanden).
Zusätzlich benötigt bin/build.js die Node-Abhängigkeiten (gray-matter). Installieren Sie diese einmalig:
- Bereiten Sie die Dokumentation vor
Das Kommando konvertiert die Wiki-Markdown-Dateien (Wikilinks, Canvas, Anhänge) aus dem Repository in den Ordner docs:
- Starten Sie den Entwicklungsserver
Der Entwicklungsserver ist unter http://localhost:8000 erreichbar:
- Produktions-Build erstellen und lokal ausliefern (optional)
Der Build wird im Ordner site abgelegt und ist unter http://localhost:8080 erreichbar.
Die Publizierung auf https://wiki.mint-system.ch erfolgt automatisch über Vercel, sobald die Änderungen auf den main Branch von https://github.com/Mint-System/Wiki gepusht werden.
Backlinks