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.
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 |
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.
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.
```python
import io
text = io.open(pfad, encoding="utf-8").read()
io.open(pfad, "w", encoding="utf-8", newline="\n").write(text)
```
Get-Content -Encoding UTF8 und Set-Content -Encoding UTF8 — niemals ohne -Encoding.
python hilfsskripte\doku-webseite-bauen.py — dann sind die Webseiten
aktuell, und die Kontrolle auf à und †läuft gleich mit.
.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.
| Was | Adresse |
|---|---|
| Übersicht aller Dokumente | http://localhost:3000/doku.html |
| Einzelnes Dokument | http://localhost:3000/doku/<name>.html |
| Rohtext zum Herunterladen | http://localhost:3000/doku/<name>.txt |
| Vom Panel aus erreichbar über | Knopf „Doku-Uebersicht (alle Dokumente)" |