INTERLIS Wiki

Zentrales, automatisch generiertes Wiki für INTERLIS – dem schweizerischen Standard zur Beschreibung von Geodatenmodellen.

Funktionsweise

urls.txt  →  generate_wiki.py  →  docs/*.md  →  GitHub Pages
            (Gemini 1.5 Flash)     (MkDocs)

1. urls.txt enthält die Quell-URLs, kommentiert mit Kategorien.
2. scripts/generate_wiki.py scrapt jede URL, sendet den Inhalt an die Google Gemini API (kostenloser Tier) und erhält strukturierte Markdown-Seiten zurück.
3. GitHub Actions führt das Script wöchentlich (oder manuell) aus, committet die Ergebnisse und deployt sie über GitHub Pages mit MkDocs.

Aufbau

interlis-wiki/
├── urls.txt                        # Eingabe: Quell-URLs
├── scripts/
│   └── generate_wiki.py            # Hauptscript
├── docs/                           # Output: generierte Wiki-Seiten (*.md)
├── .github/workflows/
│   └── generate-wiki.yml           # GitHub Actions Workflow
├── mkdocs.yml                      # MkDocs-Konfiguration
└── requirements.txt

Einrichtung

1. Google API Key holen (kostenlos)

1. Google AI Studio öffnen
2. "Create API key" klicken – fertig, kein Kreditkartenzwang
3. Den Key im GitHub-Repository unter Settings → Secrets and variables → Actions als Secret GOOGLE_API_KEY hinterlegen

2. GitHub Pages aktivieren

Unter Settings → Pages die Quelle auf GitHub Actions setzen.

3. Wiki manuell auslösen

Im Tab Actions → INTERLIS Wiki generieren → Run workflow starten.

URLs hinzufügen

Einfach urls.txt editieren und einen Commit auf main pushen – der Workflow startet automatisch.

Format:

# Kategorie-Kommentar
https://example.com/seite
https://example.com/andere-seite  Eigene Kategorie

Lokale Ausführung

pip install -r requirements.txt
export GOOGLE_API_KEY=AIza...
python scripts/generate_wiki.py

# Nur Test ohne API-Aufrufe:
python scripts/generate_wiki.py --dry-run

# Alle Seiten neu generieren:
python scripts/generate_wiki.py --force

Limits (Gemini Free Tier)

Modell	Anfragen/Minute	Anfragen/Tag
Gemini 1.5 Flash	15	1.500

Das Script pausiert 4 Sekunden zwischen Anfragen und bleibt damit sicher im Free Tier.