사용 중인 플랜
Suite Growth, Professional, Enterprise 또는 Enterprise Plus
Support(다음 포함) Guide Professional 또는 Enterprise

Guide 기본서식 작성은 헬프 센터 테마 패키지를 렌더링합니다. 여기에는 기본서식 파일, CSS 및 JS 파일, 매니페스트 파일에 사용되는 Curlybars 기본서식 작성 언어가 포함됩니다.

Guide 기본서식 작성은 기본서식 작성 API로도 알려져 있습니다.

헬프 센터 테마에 대해 자세히 알아보려면 헬프 센터 테마 사용자 지정하기 및 기본서식 작성 API 문서를 참조하세요.

이 문서에서 다루는 주제는 다음과 같습니다.
  • Guide 기본서식 작성 버전에 대한 정보
  • 기본서식 작성 버전 확인하기
  • 기본서식 작성 버전 업그레이드하기

Guide 기본서식 작성 버전에 대한 정보

다음 표에는 Guide 기본서식 작성 버전, 릴리스 날짜, 각 버전에서 사용 가능한 항목에 대한 구체적인 정보를 찾을 수 있는 관련 개발자 문서 페이지의 링크가 나열되어 있습니다.

사용 중인 버전을 확인하려면 기본서식 작성 버전 확인하기를 참조하세요.

표 1.
버전 릴리스 날짜 개발자 문서 페이지
1 2014년 11월 20일 해당 사항 없음
2 2020년 2월 24일 기본서식 작성 API v1에서 업그레이드하기
3 2023년 6월 1일 기본서식 작성 API v2에서 업그레이드하기
4 2024년 7월 2일 기본서식 작성 API v3에서 업그레이드하기

기본서식 작성 버전 확인하기

테마를 편집하거나 매니페스트 파일을 볼 때 기본서식 작성 버전을 확인할 수 있습니다.

기본서식 작성 버전을 확인하려면 다음과 같이 하세요.

  1. 지식 관리의 사이드바에서 디자인 사용자 지정()을 클릭합니다.
  2. 보려는 테마에서 사용자 지정을 클릭합니다.
  3. 코드 편집을 클릭합니다.
  4. 테마 이름 아래에 기본서식 작성 버전 번호(예: 기본서식 작성 API v2)가 보입니다.

    버전 번호는 매니페스트 파일의 api_version 필드에 해당합니다.

기본서식 작성 버전 업그레이드하기

헬프 센터 테마를 사용자 지정한 경우에는 최신 기본서식 작성 버전으로 업그레이드하여 새 기능, 향상된 성능 및 접근성 개선의 혜택을 누릴 수 있습니다.

테마 환경에서 마이그레이션한 경우 테마에 몇 가지 새로운 제한 사항이 적용됩니다. 마이그레이션 과정에서 더 사용하기 편리한 새 테마 환경으로 사용자의 테마 및 자산을 옮길 수 있도록 일부 파일 유형 및 파일 크기 사용 한도가 일시 중단됩니다.

예를 들어 테마 자산으로 더 이상 지원되지 않는 PDF 또는 기타 파일이 있는 경우에도 테마를 마이그레이션할 수 있습니다. 그런 다음에 해당 테마를 내보내서 손쉽게 그 파일들을 모두 회수할 수 있습니다. 하지만 지원되지 않는 파일을 해당 테마에서 제거하기 전에는 그 테마를 복제하거나 다시 가져올 수 없습니다.

기본서식 작성 버전을 업그레이드하려면 다음과 같이 하세요.

  1. 헬프 센터 테마를 다운로드합니다(헬프 센터 테마 다운로드하기 참조).
  2. 로컬에서 테마 패키지를 열고 manifest.json 파일을 편집합니다.
  3. manifest.json 파일에서 api_version 필드를 찾아 값을 업그레이드하려는 버전으로 변경합니다.
  4. 로컬에서 테마 변경 내용을 미리 봅니다. 테마를 미리 볼 때 업그레이드하려는 버전에서 더 이상 사용되지 않는 헬퍼를 사용 중이면 경고가 표시됩니다.
  5. 사용되지 않는 헬퍼를 사용 중인 경우에는 관련 개발자 문서를 참조하여(Guide 기본서식 작성 버전에 대한 정보 참조) 지원되는 헬퍼로 바꿉니다.

    테마를 다시 미리 보면서 더 이상 경고가 없는지 확인합니다.

  6. 업데이트된 테마를 Guide에 업로드합니다(헬프 센터 테마 가져오기 참조).

    기본서식 작성 버전을 확인하여 새 버전이 적용되었는지 확인할 수 있습니다.

Zendesk 제공