Erro: InválidoTemplates - modelo(s) com erros de sintaxe

Sinais do problema

Estou trabalhando em um tema localmente usando o tema Copenhague, e correndo para o seguinte erro InvalidTemplates - Template(s) com erros de sintaxe ao chamar yarn install e yarn start.

Etapas de resolução

Esse erro normalmente ocorre devido a um problema de formatação em um modelo de .hbs do Handlebars. Ele costuma ser acionado por listas ou objetos estruturados incorretamente, como muitos itens em um mapeamento, uma matriz ou objeto mal-formado ou um assets.hbs de expressão sem suporte.

Você também pode ver esse erro se o manifest.json do seu tema contiver uma matriz ou objeto com muitos itens, campos ausentes ou uma estrutura inválida. Isso é especialmente comum com variáveis definidas no painel de configurações. Além disso, o erro pode resultar de sintaxe não suportada em arquivos de modelo como assets.hbs ou quando determinados auxiliares de loop ou mapeamentos excedem seus limites.

Para resolver o erro, conclua as etapas de solução de problemas a seguir:

Etapa 1: Verifique sua assets.hbs
Etapa 2: Problemas de configurações do manifesto
Etapa 3: Verifique se há problemas de versão de modelos
Etapa 4: Reconstruir e testar

Etapa 1: Verifique sua `assets.hbs`

Certifique-se de que seu mapeamento ou matriz em assets.hbs não exceda o número permitido de itens. Alguns auxiliares nos modelos de tema do Zendesk aplicam limites estritos ao número de itens em um mapeamento, como uma lista ou dicionário.

Abaixo estão algumas causas típicas:

Adicionar muitos itens a um mapeamento ou lista em seu arquivo de .hbs, muitas vezes por meio de um loop grande ou um mapa/lista estático, pode causar esse problema.
Uso de sintaxe sem suporte na versão atual dos modelos.
Expressões JSON ou Handlebars malformadas.

Abaixo está um exemplo de uma lista com muitos itens:

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

Se a largeArray exceder o limite permitido do auxiliar, o sistema retornará esse erro.

Etapa 2: Problemas de configurações do manifesto

Se o erro faz referência ao manifesto ou settings, verifique se:

Qualquer identificador de variável tem mais de 30 caracteres, contém traços - em vez de sublinha _ ou tem letras maiúsculas.
O mapeamento, como um grupo de configurações, excede os limites do sistema, por exemplo, mais de 200 variáveis no total ou mais de 20 opções em uma lista.
Todas as variáveis obrigatórias, como logo e favicon, estão presentes.
Todas as variáveis de lista têm, no mínimo, duas opções e, no máximo, 20.

Etapa 3: Verificar se há problemas de versão de modelos

Verifique se há compatibilidade com a versão dos modelos:

Se você atualizou seu tema da API versão 1 ou 3 para a versão 4, certifique-se de que todos os auxiliares e blocos sejam compatíveis. Alguns auxiliares mais antigos, como o {{request_form}}, não têm mais suporte na versão 4 e devem ser substituídos de acordo com o guia de atualização.
Usar parciais ou sintaxe de mapeamento avançado que o sistema de modelos do Zendesk não Support também pode acionar esse erro.

Etapa 4: Recriar e testar

Após fazer as correções:

Salvar todas as alterações.
Execute o yarn start para recompilar o tema.
Verifique se o erro não é mais exibido.

Para obter mais informações, consulte o artigo: Trabalho local em um tema.

Aviso sobre a tradução: este artigo foi traduzido por um software de tradução automática para oferecer a você uma compreensão básica do conteúdo. Medidas razoáveis foram tomadas para fornecer uma tradução precisa, no entanto, a Zendesk não garante a precisão da tradução.