Manuel · 17
Dépannage
| Problème | Cause et solution |
|---|---|
| « Render error » sur le site | Une erreur de template. Une fois connecté, vous voyez le message exact avec la ligne ; l’aperçu en direct l’affiche également. |
unable to resolve template / snippet "x" does not exist |
Un include, component ou extends fait référence à un Snippet qui n’existe pas (ou plus) – vérifiez le nom, casse comprise. |
{% fill %} is only allowed inside {% component %} … |
Un fill se trouve en dehors d’un composant, ou un endcomponent manque. |
nested more than 30 levels deep |
Un composant s’appelle lui-même (directement ou via d’autres). |
Le HTML apparaît comme texte (<b>) |
Échappement automatique. Pour les champs HTML |safe, pour le Markdown |markdown ; de même pour les paramètres de composants (text=post.text|markdown). |
| La page renvoie 404 alors qu’elle existe | Non publiée ? Vérifiez en étant connecté avec ?preview=1. Avec plusieurs sites : le domaine appelé appartient-il au bon site ? En local, ouvrez-la via le lien de chemin de l’éditeur (définit ?_site=). |
| Le mauvais site s’affiche | Le domaine est-il déclaré pour le site ? Les domaines inconnus affichent le site par défaut. En tant qu’administrateur, changez la sélection mémorisée avec ?_site=<ID> du site souhaité. |
{{ … }} doit apparaître littéralement |
Le placer dans {% verbatim %}…{% endverbatim %}. |
| L’import de macro échoue | La macro a besoin de export : {% macro name(…) export %}. |
| Des données REST manquent ou la page s’interrompt | Sous Sources REST → Tester la requête : vérifiez le statut, le chemin de la liste et les espaces réservés. Les variables d’environnement ont-elles été définies au démarrage du serveur ? |
| Modifications d’images invisibles après une réimportation | Les navigateurs mettent les images en cache pendant un jour – rechargez avec Ctrl+Maj+R. |
| Formater signale une erreur | Le HTML est erroné (p. ex. une balise non fermée) – la ligne et la colonne figurent dans le message. |
L’aperçu n’affiche pas les données de fetch() |
L’aperçu est isolé et n’a pas le droit d’appeler l’API ; sur la vraie page, cela fonctionne. |