Häufige Fehler vermeiden
Beim Arbeiten mit OpenSDG kommt es immer wieder zu typischen Stolpersteinen, die zu Anzeigeproblemen, fehlerhaften Übersetzungen oder sogar dem kompletten Abbruch des Seitenaufbaus führen können. Dieser Abschnitt hilft dabei, diese Fehler zu vermeiden – sowohl bei redaktionellen als auch bei technischen Änderungen.
YAML-Fehler
Häufige Probleme:
| Problem | Erklärung | Lösung |
|---|---|---|
| Falsche Einrückung | YAML verlangt Einrückungen mit 2 Leerzeichen, keine Tabs. | Verwende immer genau 2 Leerzeichen pro Ebene. |
| Ungültige Zeichen | Sonderzeichen (z. B. &, :) können YAML unbrauchbar machen. |
Solche Zeichen in Anführungszeichen setzen oder vermeiden. |
Fehlende Trennlinie (---) |
Trennt Metadaten und Text. Ohne diese wird der Fließtext nicht erkannt. | Immer --- nach dem YAML-Block einfügen. |
Übersetzungsprobleme
Häufige Probleme:
| Problem | Erklärung | Lösung |
|---|---|---|
| Platzhalter nicht gefunden | Falscher oder fehlender Schlüssel in der Übersetzungsdatei. | Schreibweise prüfen, Datei und Schlüssel existieren lassen. |
| Falscher Sprachcode | OpenSDG erwartet z. B. de für Deutsch. |
Immer ISO 639-1 Sprachcodes nutzen. |
Strukturprobleme im Projekt
Häufige Probleme:
| Problem | Erklärung | Lösung |
|---|---|---|
| Falscher Dateiname | YAML-Dateien für Indikatoren müssen z. B. 3-2-1.yml heißen. |
Schema korrekt einhalten. |
| Datei liegt im falschen Repo | Daten gehören ins Data-Repo, Inhalte (z. B. Startseite) ins Site-Repo. | Repositories korrekt trennen. |
CSV-spezifische Fehler
Besonders häufig in Datendateien:
| Problem | Erklärung | Lösung |
|---|---|---|
| Komma als Dezimalzeichen | In CSV-Dateien muss der Dezimaltrenner ein Punkt sein, nicht ein Komma. | Z. B. 3.14 statt 3,14 verwenden. |
| Falsches Trennzeichen | Statt Kommata werden manchmal Semikola verwendet. | Datei als „CSV (Comma-separated)“ exportieren, nicht als „CSV (Semicolon-separated)“. |
Technische Fallstricke
Weitere häufige Ursachen für Fehler:
- Groß-/Kleinschreibung: OpenSDG ist in vielen Fällen case-sensitive.
- Fehlende Dateien: Eine verlinkte Datei (z. B. ein Bild oder ein Template) existiert nicht oder wurde nicht korrekt in den
site-Ordner übernommen. - Build schlägt fehl: Lokales Testen mit
mkdocs servehilft, Fehler frühzeitig zu erkennen.
Tipps zur Fehlersuche
- Baue die Seite lokal mit
mkdocs buildodermkdocs serve. - Schau dir die Konsole auf Fehler oder Warnungen an.
- Nutze ggf. YAML-Validatoren zur Prüfung.
Fazit
Fehler lassen sich nicht ganz vermeiden – aber wer sie kennt, spart Zeit und Nerven. Eine strukturierte Arbeitsweise und regelmäßige Tests sind der Schlüssel zu einer stabilen und barrierearmen SDG-Plattform.