Manuale · 17

Risoluzione dei problemi

Problema	Causa e soluzione
“Render error” sul sito	Un errore di template. Se hai effettuato l’accesso vedi il messaggio esatto con la riga; anche l’anteprima dal vivo lo mostra.
`unable to resolve template` / `snippet "x" does not exist`	Un `include`, `component` o `extends` rimanda a uno snippet che non esiste (più) – controlla il nome, anche maiuscole/minuscole.
`{% fill %} is only allowed inside {% component %} …`	Un `fill` si trova fuori da un componente oppure manca un `endcomponent`.
`nested more than 30 levels deep`	Un componente richiama se stesso (direttamente o tramite altri).
L’HTML compare come testo (`<b>`)	Escape automatico. Per i campi HTML `\|safe`, per Markdown `\|markdown`; lo stesso vale per i parametri dei componenti (`text=post.text\|markdown`).
La pagina restituisce 404 anche se esiste	Non pubblicata? Controlla con l’accesso effettuato usando `?preview=1`. Con più siti: il dominio richiesto appartiene al sito giusto? In locale apri con il link del percorso dall’editor (imposta `?_site=`).
Compare il sito sbagliato	Il dominio è inserito nel sito? I domini sconosciuti mostrano il sito predefinito. Come amministratore cambia la selezione memorizzata con `?_site=<ID>` del sito desiderato.
`{{ … }}` deve comparire alla lettera	Mettilo in `{% verbatim %}…{% endverbatim %}`.
L’import di una macro non riesce	La macro ha bisogno di `export`: `{% macro name(…) export %}`.
Mancano dati REST o la pagina si interrompe	In Sorgenti REST → Prova richiesta: controlla stato, percorso della lista, segnaposto. Le variabili d’ambiente sono state impostate all’avvio del server?
Modifiche alle immagini non visibili dopo una reimportazione	I browser memorizzano le immagini per un giorno – ricarica con Ctrl+Shift+R.
Formatta segnala un errore	L’HTML contiene errori (ad es. un tag non chiuso) – riga/colonna sono indicate nel messaggio.
L’anteprima non mostra dati da `fetch()`	L’anteprima è isolata e non può richiamare l’API; nella pagina reale funziona.