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

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

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

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

이 문서에서 다루는 주제는 다음과 같습니다.

• Guide 기본서식 작성 버전에 대한 정보
• 기본서식 작성 버전 확인하기
• Guide 기본서식 작성 버전 업그레이드하기

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

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

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

표 1.

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

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

테마 또는 매니페스트 파일의 코드 편집 보기에서 기본서식 작성 버전을 볼 수 있습니다.

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

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

   

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

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

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

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

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

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

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

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