문제 증상

Copenhagen 테마를사용하여 로컬에서 테마에서 작업 중이며, 호출 시InvalidTemplates - Template(s) with 구문 오류가 발생합니다.yarn install및 yarn start.

해결 단계

이 오류는 일반적으로 핸들바의 서식 문제로 인해 발생합니다. .hbs기본서식을 참조하세요. 맵핑에 너무 많은 항목, 잘못된 형식의 배열이나 개체, 지원되지 않는 표현식 등 부적절하게 구조화된 목록이나 개체로 인해 종종 트리거됩니다. assets.hbs.

테마가manifest.json항목이 너무 많거나, 필드가 없거나, 구조가 올바르지 않은 배열이나 개체를 포함합니다. 이는 특히 설정 창에서 정의된 변수에 일반적입니다. 또한 다음과 같은 기본서식 파일에서 지원되지 않는 구문으로 인해 오류가 발생할 수 있습니다. assets.hbs또는 특정 루프 헬퍼나 맵핑이 한도를 초과할 때 사용할 수 있습니다.

오류를 해결하려면 다음 문제 해결 단계를 완료하세요.

  • 1단계: 확인 assets.hbs
  • 2단계: 매니페스트 설정 문제
  • 3단계: 기본서식 작성 버전 문제 확인
  • 4단계: 다시 구축 및 테스트

1단계: 확인 assets.hbs

의 맵핑 또는 배열이assets.hbs은(는) 허용되는 항목 수를 초과하지 않습니다. Zendesk 테마 기본서식의 일부 도우미는 목록이나 사전과 같은 맵핑의 항목 수에 엄격한 제한을 적용합니다.

다음은 몇 가지 일반적인 원인입니다.

  • 의 맵핑이나 목록에 너무 많은 항목을 추가하는 경우.hbs파일이 큰 루프나 정적 맵/목록을 통해 자주 발생하면 이 문제가 트리거될 수 있습니다.
  • 현재 기본서식 작성 버전에서 지원되지 않는 구문을 사용합니다.
  • 잘못된 형식의 JSON 또는 핸들바 표현식.

다음은 항목이 너무 많은 목록의 예입니다.

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

IflargeArray이(가) 도우미의 허용 한도를 초과하면 시스템에서 이 오류를 리턴합니다.

2단계: 매니페스트 설정 문제

오류가 매니페스트 또는settings, 다음 사항을 확인하세요.

  • 모든 변수 식별자가 30자를 초과하며 대시를 포함합니다. -밑줄 대신 _, 또는 대문자입니다.
  • 설정 그룹과 같은 맵핑이 시스템 제한을 초과합니다(예: 목록의 총 변수 200개 이상 또는 옵션 20개 이상).
  • 다음과 같은 모든 필수 변수 logo및favicon이(가) 있습니다.
  • 모든 목록 변수에는 2개 이상 20개 이하의 옵션이 있습니다.

3단계: 기본서식 작성 버전 문제 확인

기본서식 작성 버전 호환성 확인:

  • API 버전 1 또는 3에서 버전 4로 테마를 업그레이드한 경우에는 모든 헬퍼와 블록이 호환되는지 확인하세요. 다음과 같은 일부 오래된 헬퍼는 {{request_form}}은(는) 버전 4에서 더 이상 지원되지 않으므로 업그레이드 가이드에 따라 바꿔야 합니다.
  • Zendesk의 기본서식 시스템에서 지원하지 않는 부분 또는 고급 맵핑 구문을 사용하는 경우에도 이 오류가 발생할 수 있습니다.

4단계: 다시 구축 및 테스트

수정 후:

  1. 모든 변경 내용을 저장합니다.
  2. 실행 yarn start하여 테마를 다시 컴파일합니다.
  3. 오류가 더 이상 나타나지 않는지 확인합니다.

자세한 내용은 로컬에서 테마 작업하기

번역 고지 사항: 본 문서는 콘텐츠에 대한 기본적인 이해를 제공하기 위해 자동 번역 소프트웨어를 사용하여 번역되었습니다. 정확한 번역을 제공하고자 합당한 노력을 기울였으나 Zendesk는 번역의 정확성을 보장하지 않습니다.

번역된 문서에 포함된 정보의 정확성과 관련하여 질문이 있으시면 문서의 공식 버전인 영문 버전을 참조하시기 바랍니다.

Zendesk 제공