Handbuch · 17
Fehlerbehebung
| Problem | Ursache und Lösung |
|---|---|
| „Render error“ auf der Website | Ein Template-Fehler. Eingeloggt siehst du die genaue Meldung mit Zeile; die Live-Vorschau zeigt sie ebenfalls. |
unable to resolve template / snippet "x" does not exist |
Ein include, component oder extends verweist auf ein Snippet, das es nicht (mehr) gibt – Name prüfen, auch Groß-/Kleinschreibung. |
{% fill %} is only allowed inside {% component %} … |
Ein fill steht außerhalb einer Komponente oder ein endcomponent fehlt. |
nested more than 30 levels deep |
Eine Komponente ruft sich (direkt oder über andere) selbst auf. |
HTML erscheint als Text (<b>) |
Automatisches Escaping. Für HTML-Felder |safe, für Markdown |markdown; bei Komponenten-Parametern ebenso (text=post.text|markdown). |
| Seite liefert 404, obwohl sie existiert | Nicht veröffentlicht? Eingeloggt mit ?preview=1 prüfen. Bei mehreren Websites: Gehört die aufgerufene Domain zur richtigen Website? Lokal mit dem Pfad-Link aus dem Editor öffnen (setzt ?_site=). |
| Falsche Website erscheint | Domain bei der Website eingetragen? Unbekannte Domains zeigen die Standard-Website. Als Admin gemerkte Auswahl per ?_site=<ID> der gewünschten Website wechseln. |
{{ … }} soll wörtlich erscheinen |
In {% verbatim %}…{% endverbatim %} setzen. |
| Macro-Import schlägt fehl | Das Makro braucht export: {% macro name(…) export %}. |
| REST-Daten fehlen oder Seite bricht ab | Unter REST-Quellen → Abruf testen: Status, Listen-Pfad, Platzhalter prüfen. Umgebungsvariablen beim Serverstart gesetzt? |
| Änderungen an Bildern nach Re-Import nicht sichtbar | Browser speichern Bilder einen Tag zwischen – Neuladen mit Strg+Umschalt+R. |
| Formatieren meldet einen Fehler | Das HTML ist fehlerhaft (z. B. ein nicht geschlossenes Tag) – Zeile/Spalte steht in der Meldung. |
Vorschau zeigt keine Daten aus fetch() |
Die Vorschau ist abgeschottet und darf die API nicht aufrufen; auf der echten Seite funktioniert es. |