← zur Übersicht

Umlaute, Zeichen und wie sie heil bleiben


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:

DateiStellen
docs\00-INDEX.md170
docs\12-LIVEKIT-LOKAL.md70
hilfsskripte\panel-neue-lehrwege.sh22
playbooks\00-server-anlegen.yml15

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

```python

import io

text = io.open(pfad, encoding="utf-8").read()

io.open(pfad, "w", encoding="utf-8", newline="\n").write(text)

```

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.

5. Wo man es jetzt sieht

WasAdresse
Übersicht aller Dokumentehttp://localhost:3000/doku.html
Einzelnes Dokumenthttp://localhost:3000/doku/<name>.html
Rohtext zum Herunterladenhttp://localhost:3000/doku/<name>.txt
Vom Panel aus erreichbar überKnopf „Doku-Uebersicht (alle Dokumente)"