--- titel: Umlaute, Zeichen und wie sie heil bleiben stand: 01.11.2026 zweck: Warum am 01.11. „zählt" in der Doku stand, wie es repariert wurde und wie man es künftig vermeidet. --- # Umlaute und Zeichen ## 1. Was passiert war In der Doku stand statt „zählt" plötzlich **„zählt"** und statt „…" ein **„…"**. Betroffen waren zwei Dokumente und zwei Skripte: | Datei | Stellen | |---|---| | `docs\00-INDEX.md` | 170 | | `docs\12-LIVEKIT-LOKAL.md` | 70 | | `hilfsskripte\panel-neue-lehrwege.sh` | 22 | | `playbooks\00-server-anlegen.yml` | 15 | ## 2. Warum Eine Datei wurde mit **Windows PowerShell 5.1** gelesen (`Get-Content -Raw`), ohne die Kodierung anzugeben. PowerShell 5.1 nimmt dann die Windows-Codepage (ANSI), nicht UTF-8. Die UTF-8-Bytes von „ä" (`C3 A4`) wurden als zwei Zeichen gelesen und beim Zurückschreiben als UTF-8 gespeichert — aus `ä` wurde `ä`. Das passiert **nur beim Lesen und Zurückschreiben** einer Datei. Ein reines Anhängen (`Add-Content -Encoding UTF8`) ist unschädlich. ## 3. Wie es repariert wurde `hilfsskripte\umlaute-reparieren.py` (früher Einmal-Skript `fixuml.py`): liest die Datei als UTF-8, ersetzt die typischen Doppelzeichen (`ä` → `ä`, `…` → `…`, `—` → `—` und so weiter) und schreibt UTF-8 mit LF zurück. Nach der Reparatur: **277 Stellen** in vier Dateien, danach eine Kontrolle über alle `.md`, `.yml` und `.sh` im Projekt — **null Treffer**. ## 4. Regeln für die Zukunft 1. **Dateien immer mit Python bearbeiten**, nicht mit PowerShell-Textbefehlen: ```python import io text = io.open(pfad, encoding="utf-8").read() io.open(pfad, "w", encoding="utf-8", newline="\n").write(text) ``` 2. Wenn PowerShell: `Get-Content -Encoding UTF8` **und** `Set-Content -Encoding UTF8` — niemals ohne `-Encoding`. 3. Nach jeder automatischen Änderung an der Doku: `python hilfsskripte\doku-webseite-bauen.py` — dann sind die Webseiten aktuell, und die Kontrolle auf `Ã` und `â€` läuft gleich mit. 4. In der Weboberfläche: die Seiten werden als HTML ausgeliefert, nicht als `.md`. Ein Link auf `file:///…md` tut in Chrome **nichts** — eine über http geladene Seite darf keine lokalen Dateien öffnen. Deshalb der Umweg über `doku-webseite-bauen.py`. ## 5. Wo man es jetzt sieht | Was | Adresse | |---|---| | Übersicht aller Dokumente | `http://localhost:3000/doku.html` | | Einzelnes Dokument | `http://localhost:3000/doku/.html` | | Rohtext zum Herunterladen | `http://localhost:3000/doku/.txt` | | Vom Panel aus erreichbar über | Knopf „Doku-Uebersicht (alle Dokumente)" |