Errore: Modelli non validi - Modelli con errori di sintassi

Sintomi del problema

Sto lavorando a un tema in locale usando il tema Copenhagene ho riscontrato il seguente errore InvalidTemplates - Template(s) with sintax error(s) durante la chiamata yarn install e yarn start.

Passaggi per la risoluzione

Questo errore si verifica in genere a causa di un problema di formattazione in un manubrio .hbs modello. Spesso è innescato da elenchi o oggetti strutturati in modo errato, come troppi elementi in una mappatura, un array o un oggetto non corretto o un’espressione non supportata assets.hbs.

Potresti visualizzare questo errore anche se il tuo tema èmanifest.jsoncontiene un array o un oggetto con troppi elementi, campi mancanti o una struttura non valida. Ciò è particolarmente comune con le variabili definite nel pannello delle impostazioni. Inoltre, l’errore può derivare da una sintassi non supportata nei file modello, come assets.hbs o quando determinati loop helper o mappature superano i rispettivi limiti.

Per risolvere l’errore, completa i seguenti passaggi per la risoluzione dei problemi:

Fase 1: Controlla il tuo assets.hbs
Fase 2: Problemi con le impostazioni del file manifest
Fase 3: Verifica la presenza di problemi con la versione dei modelli
Fase 4: Ricompila e prova

Passaggio 1. Controlla il tuo `assets.hbs`

Assicurati che la mappatura o l’array inassets.hbsnon supera il numero consentito di elementi. Alcuni helper nei modelli di temi Zendesk impongono limiti rigorosi al numero di elementi in una mappatura, come un elenco o un dizionario.

Di seguito sono elencate alcune cause tipiche:

Aggiunta di troppi elementi a una mappatura o a un elenco in.hbs file spesso attraverso un ciclo di grandi dimensioni o una mappa/elenco statico possono causare questo problema.
Uso di una sintassi non supportata dalla versione attuale dei modelli.
Espressioni JSON o Handlebars non corrette.

Di seguito è riportato un esempio di elenco con troppi elementi:

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

SelargeArraysupera il limite consentito dall’helper, il sistema restituirà questo errore.

Passaggio 2. Problemi con le impostazioni del file manifest

Se l’errore fa riferimento al file manifest osettings, controlla se:

Qualsiasi identificatore di variabile è più lungo di 30 caratteri e contiene trattini - anziché i caratteri di sottolineatura _o ha lettere maiuscole.
La mappatura, ad esempio un gruppo di impostazioni, supera i limiti di sistema, ad esempio più di 200 variabili in totale o più di 20 opzioni in un elenco.
Tutte le variabili obbligatorie come logoefavicon sono presenti.
Tutte le variabili elenco hanno almeno due opzioni e non più di 20.

Passaggio 3. Verifica la presenza di problemi con la versione dei modelli

Verifica la compatibilità delle versioni dei modelli:

Se hai aggiornato il tema dalla versione API 1 o 3 alla versione 4, assicurati che tutti gli helper e i blocchi siano compatibili. Alcuni helper meno recenti, come {{request_form}}, non sono più supportati nella versione 4 e devono essere sostituiti in base alla guida all’aggiornamento.
Anche l’uso di parziali o di una sintassi di mappatura avanzata non assistenza dal sistema di modelli di Zendesk può causare questo errore.

Passaggio 4. Ricompila e prova

Dopo aver apportato le correzioni:

Salva tutte le modifiche.
Esegui yarn start per ricompilare il tema.
Verifica che l’errore non venga più visualizzato.

Per ulteriori informazioni, leggi l’articolo: Uso di un tema in locale

Avvertenza sulla traduzione: questo articolo è stato tradotto usando un software di traduzione automatizzata per fornire una comprensione di base del contenuto. È stato fatto tutto il possibile per fornire una traduzione accurata, tuttavia Zendesk non garantisce l'accuratezza della traduzione.