Symptômes

Je travaille sur un thème en local en utilisant le thème Copenhagenet je rencontre l’erreur suivante InvalidTemplates - Template(s) avec une ou plusieurs erreurs de syntaxe lors de l’appel yarn install et yarn start.

Étapes de résolution

Cette erreur se produit généralement en raison d’un problème de formatage dans un Handlebars .hbs . Elle est souvent déclenchée par des listes ou des objets mal structurés, comme trop d’éléments dans un mappage, un tableau ou un objet mal formé ou une expression non prise en charge. assets.hbs.

Il est aussi possible que vous voyiez cette erreur si votre thèmemanifest.jsoncontient un tableau ou un objet avec trop d’éléments, des champs manquants ou une structure non valide. C’est particulièrement courant avec les variables définies dans le volet des paramètres. En outre, l’erreur peut provenir d’une syntaxe non prise en charge dans les fichiers modèles comme assets.hbs ou quand certains assistants de boucles ou mappages dépassent leurs limites.

Pour résoudre cette erreur, suivez les étapes de dépannage suivantes :

  • Étape 1 : Vérifiez vos assets.hbs
  • Étape 2 : Problèmes liés aux paramètres de manifeste
  • Étape 3 : Vérifiez les problèmes de version de création de modèles
  • Étape 4 : Recréer et tester

Étape 1 : Vérifiez vos assets.hbs

Vérifiez que votre mappage ou tableau est dans lesassets.hbsne dépasse pas le nombre d’éléments autorisé. Certains assistants dans les modèles de thème Zendesk appliquent des limites strictes du nombre d’éléments dans un mappage, comme une liste ou un dictionnaire.

Voici quelques causes courantes :

  • Ajout de trop d’éléments à un mappage ou une liste dans votre.hbs fichier souvent par le biais d’une boucle volumineuse ou d’une carte/liste statique peut déclencher ce problème.
  • Utilisation d’une syntaxe non prise en charge par la version de création de modèles actuelle.
  • Expressions Handlebars ou JSON mal formées.

Voici un exemple d’une liste avec trop d’éléments :

{{#each largeArray}}
 ... output ...
{{/each}}

SilargeArraydépasse la limite autorisée pour l’assistant, le système renvoie cette erreur.

Étape 2 : Problèmes liés aux paramètres de manifeste

Si l’erreur fait référence au manifeste ousettings, vérifiez si :

  • Tout identifiant de variable comporte plus de 30 caractères, contient des tirets - au lieu de traits de soulignement _, ou avec des lettres majuscules.
  • Le mappage avec un groupe de paramètres dépasse les limites système, par exemple plus de 200 variables au total ou plus de 20 options dans une liste.
  • Toutes les variables obligatoires comme logoetfavicon sont présentes.
  • Toutes les variables de liste ont au moins deux options et pas plus de 20.

Étape 3 : Vérifiez les problèmes de version de création de modèles

Vérifiez la compatibilité des versions de création de modèles :

  • Si vous avez mis votre thème à niveau de l’API version 1 ou 3 à la version 4, vérifiez que tous les assistants et blocs sont compatibles. Certains assistants plus anciens, comme {{request_form}}, ne sont plus pris en charge dans la version 4 et doivent être remplacés en suivant les instructions du guide de mise à niveau.
  • L’utilisation d’une syntaxe de mappage partielle ou avancée que le système de modèles Zendesk ne prend pas en assistance peut aussi déclencher cette erreur.

Étape 4 : Recréer et tester

Après les corrections :

  1. Enregistrez toutes les modifications.
  2. Exécuter yarn start pour recompiler le thème.
  3. Vérifiez que l’erreur ne s’affiche plus.

Pour en savoir plus, consultez l’article : Travailler sur un thème en local

Traduction - exonération : cet article a été traduit par un logiciel de traduction automatisée pour permettre une compréhension élémentaire de son contenu. Des efforts raisonnables ont été faits pour fournir une traduction correcte, mais Zendesk ne garantit pas l’exactitude de la traduction.

Si vous avez des questions quant à l’exactitude des informations contenues dans l’article traduit, consultez la version anglaise de l’article, qui représente la version officielle.

Réalisé par Zendesk