Síntomas del problema

Estoy trabajando en un tema localmente usando el tema Copenhague, y me encuentro con el siguiente error InvalidTemplates - Template(s) with syntax error(s) al llamar a yarn install y yarn start.

Pasos de resolución

Este error ocurre normalmente debido a un problema de formato en una plantilla de .hbs de manillar. A menudo se gatilla por listas u objetos mal estructurados, como demasiados elementos en un mapeo, una matriz u objeto malformado o un assets.hbs de expresión no admitido.

También podría ver este error si el manifest.json de su tema contiene una matriz u objeto con demasiados elementos, campos que faltan o una estructura no válida. Esto es especialmente común con las variables definidas en el panel de configuración. Además, el error puede deberse a una sintaxis no admitida en archivos de plantilla como assets.hbs o cuando ciertos helpers de bucle o mapeos exceden sus límites.

Para resolver el error, siga los siguientes pasos de resolución de problemas:

  • Paso 1: Verifique su assets.hbs
  • Paso 2: Problemas de configuración del manifiesto
  • Paso 3: Buscar problemas con la versión de creación de plantillas
  • Paso 4: Reconstruir y probar

Paso 1: Verifique su assets.hbs

Asegúrese de que el mapeo o matriz en assets.hbs no exceda el número permitido de elementos. Algunos asistentes en las plantillas de temas de Zendesk imponen límites estrictos al número de elementos en un mapeo, como una lista o un diccionario.

Las siguientes son algunas causas típicas:

  • Agregar demasiados elementos a un mapeo o una lista en el archivo de .hbs a menudo a través de un bucle grande o un mapa/lista estático puede desencadenar este problema.
  • Usar la sintaxis no admitida por la versión de plantillas actual.
  • Expresiones JSON o Handlebars malformadas.

El siguiente es un ejemplo de una lista con demasiados elementos:

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

Si largeArray excede el límite permitido del helper, el sistema devolverá este error.

Paso 2: Problemas de configuración del manifiesto

Si el error hace referencia al manifiesto o settings, verifique si:

  • Cualquier identificador de variable tiene más de 30 caracteres, contiene - de guiones en lugar de _ de subrayado o mayúsculas.
  • El mapeo, como un grupo de configuración, excede los límites del sistema, por ejemplo, más de 200 variables totales o más de 20 opciones en una lista.
  • Están presentes todas las variables necesarias, como logo y favicon.
  • Todas las variables de la lista tienen por lo menos dos opciones, y no más de 20.

Paso 3: Buscar problemas con la versión de creación de plantillas

Verifique la compatibilidad de la versión de creación de plantillas:

  • Si actualizó su tema de API versión 1 o 3 a versión 4, asegúrese de que todos los helpers y bloques sean compatibles. Algunos helpers más antiguos, como {{request_form}}, ya no son compatibles con la versión 4 y deben reemplazarse según la guía de actualización.
  • El uso de la sintaxis de mapeo parcial o avanzado que el sistema de plantillas de Zendesk no Support también puede desencadenar este error.

Paso 4: Reconstruir y probar

Después de hacer las correcciones:

  1. Guarde todos los cambios.
  2. Ejecute yarn start para recompilar el tema.
  3. Verifique que el error ya no aparezca.

Para obtener más información, consulte el artículo: Trabajar en un tema localmente.

Descargo de responsabilidad de la traducción: Este artículo ha sido traducido usando software de traducción automática para proporcionar una idea básica del contenido. Se han realizado esfuerzos razonables para proporcionar una traducción exacta, sin embargo, Zendesk no garantiza la exactitud de la traducción.

Si surge alguna pregunta relacionada con la exactitud de la información incluida en el artículo traducido, consulte la versión en inglés del artículo, que es la versión oficial.

Tecnología de Zendesk