Manual · 17
Solución de problemas
| Problema | Causa y solución |
|---|---|
| «Render error» en el sitio web | Un error de template. Con la sesión iniciada ves el mensaje exacto con la línea; la vista previa en vivo también lo muestra. |
unable to resolve template / snippet "x" does not exist |
Un include, component o extends hace referencia a un Snippet que no existe (o ya no existe): comprueba el nombre, también las mayúsculas y minúsculas. |
{% fill %} is only allowed inside {% component %} … |
Un fill está fuera de un componente o falta un endcomponent. |
nested more than 30 levels deep |
Un componente se llama a sí mismo (directamente o a través de otros). |
El HTML aparece como texto (<b>) |
Escapado automático. Para campos HTML, |safe; para Markdown, |markdown; igual en los parámetros de componentes (text=post.text|markdown). |
| Una página devuelve 404 aunque existe | ¿No está publicada? Compruébalo con la sesión iniciada y ?preview=1. Con varios sitios web: ¿pertenece el dominio solicitado al sitio web correcto? En local, ábrela con el enlace de ruta del editor (añade ?_site=). |
| Aparece el sitio web equivocado | ¿Está registrado el dominio en el sitio web? Los dominios desconocidos muestran el sitio web predeterminado. Como administrador, cambia la selección recordada con ?_site=<ID> del sitio web deseado. |
{{ … }} debe aparecer literalmente |
Ponlo dentro de {% verbatim %}…{% endverbatim %}. |
| Falla la importación de una macro | La macro necesita export: {% macro name(…) export %}. |
| Faltan datos REST o la página se interrumpe | En Fuentes REST → Probar consulta: comprueba el estado, la ruta de la lista y los marcadores. ¿Se definieron las variables de entorno al arrancar el servidor? |
| Los cambios en imágenes no se ven tras una reimportación | Los navegadores guardan las imágenes en caché un día: recarga con Ctrl+Shift+R. |
| Formatear da un error | El HTML tiene errores (p. ej. una etiqueta sin cerrar): la línea y la columna aparecen en el mensaje. |
La vista previa no muestra datos de fetch() |
La vista previa está aislada y no puede llamar a la API; en la página real funciona. |