Guide 기본서식 작성은 헬프 센터 테마 패키지를 렌더링합니다. 여기에는 기본서식 파일, CSS 및 JS 파일, 매니페스트 파일에 사용되는 Curlybars 기본서식 작성 언어가 포함됩니다.
Guide 기본서식 작성은 기본서식 작성 API로도 알려져 있습니다.
헬프 센터 테마에 대해 자세히 알아보려면 헬프 센터 테마 사용자 지정하기 및 기본서식 작성 API 문서를 참조하세요.
Guide 기본서식 작성 버전에 대한 정보
다음 표에는 Guide 기본서식 작성 버전, 릴리스 날짜, 각 버전에서 사용 가능한 항목에 대한 구체적인 정보를 찾을 수 있는 관련 개발자 문서 페이지의 링크가 나열되어 있습니다.
사용 중인 버전을 확인하려면 기본서식 작성 버전 확인하기를 참조하세요.
버전 | 릴리스 날짜 | 개발자 문서 페이지 |
---|---|---|
1 | 2014년 11월 20일 | 해당 사항 없음 |
2 | 2020년 2월 24일 | 기본서식 작성 API v1에서 업그레이드하기 |
3 | 2023년 6월 1일 | 기본서식 작성 API v2에서 업그레이드하기 |
4 | 2024년 7월 2일 | 기본서식 작성 API v3에서 업그레이드하기 |
기본서식 작성 버전 업그레이드하기
헬프 센터 테마를 사용자 지정한 경우에는 최신 기본서식 작성 버전으로 업그레이드하여 새 기능, 향상된 성능 및 접근성 개선의 혜택을 누릴 수 있습니다.
테마 환경에서 마이그레이션한 경우 테마에 몇 가지 새로운 제한 사항이 적용됩니다. 마이그레이션 과정에서 더 사용하기 편리한 새 테마 환경으로 사용자의 테마 및 자산을 옮길 수 있도록 일부 파일 유형 및 파일 크기 사용 한도가 일시 중단됩니다.
예를 들어 테마 자산으로 더 이상 지원되지 않는 PDF 또는 기타 파일이 있는 경우에도 테마를 마이그레이션할 수 있습니다. 그런 다음에 해당 테마를 내보내서 손쉽게 그 파일들을 모두 회수할 수 있습니다. 하지만 지원되지 않는 파일을 해당 테마에서 제거하기 전에는 그 테마를 복제하거나 다시 가져올 수 없습니다.
기본서식 작성 버전을 업그레이드하려면 다음과 같이 하세요.
- 헬프 센터 테마를 다운로드합니다(헬프 센터 테마 다운로드하기 참조).
- 로컬에서 테마 패키지를 열고 manifest.json 파일을 편집합니다.
-
manifest.json 파일에서
api_version
필드를 찾아 값을 업그레이드하려는 버전으로 변경합니다. - 로컬에서 테마 변경 내용을 미리 봅니다. 테마를 미리 볼 때 업그레이드하려는 버전에서 더 이상 사용되지 않는 헬퍼를 사용 중이면 경고가 표시됩니다.
- 사용되지 않는 헬퍼를 사용 중인 경우에는 관련 개발자 문서를 참조하여(Guide 기본서식 작성 버전에 대한 정보 참조) 지원되는 헬퍼로 바꿉니다.
테마를 다시 미리 보면서 더 이상 경고가 없는지 확인합니다.
- 업데이트된 테마를 Guide에 업로드합니다(헬프 센터 테마 가져오기 참조).
기본서식 작성 버전을 확인하여 새 버전이 적용되었는지 확인할 수 있습니다.