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

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

Guide 기본서식 작성을 Templating API라고도 합니다.

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

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

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

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

2020년 2월 24일에 Templating API V2가 출시되었고 이 버전은 Copenhagen 테마 및 모든 새 테마 릴리스에 적용됩니다.

테마를 사용자 지정한 경우에는 Templating API V1을 계속 사용할 수 있으며 새로운 기능 및 향상된 성능을 사용하지 않으려는 한 V2로 업그레이드하지 않아도 됩니다. Guide에서 어느 버전의 프레임워크를 사용 중인지 확인할 수 있습니다(기본서식 작성 버전 확인하기 참조).

V2에서는 vanilla JavaScript(script.js 또는 document_head.hbs 등)를 사용할 수 있는 테마의 어디에서든 더 이상 jQuery 문을 사용할 수 없습니다. V2에서 jQuery를 사용하려면 jQuery 라이브러리를 가져와야 합니다.

또한 일부 헬퍼가 더 이상 사용되지 않으며 일부 헬퍼는 HTML 대신 데이터 개체를 출력하도록 변경되었습니다. 전체 목록은 여기를 참조하세요.

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

테마나 메니페스트 파일의 코드 편집 보기에서 기본서식 작성 버전을 확인할 수 있습니다.

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

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

   

   이 버전 번호는 메니페스트 파일의 api_version 필드에 상응합니다.

Guide 기본서식 작성 버전 1에서 버전 2로 업그레이드하기

Guide 테마를 사용자 지정한 경우 버전 2로 업그레이드하여 새로운 기능 및 향상된 성능을 누릴 수 있습니다.

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

1. 헬프 센터 테마를 다운로드합니다(헬프 센터 테마 다운로드하기 참조).
2. 로컬에서 테마 패키지를 열고 manifest.json 파일을 편집합니다.
3. manifest.json 파일에서 api_version 필드를 찾아 값을 2로 변경합니다.
4. 로컬에서 테마 변경 내용을 미리 봅니다. 테마를 미리 볼 때 버전 2에서 사용이 중지된 헬퍼를 사용하는 경우에는 경고가 나타납니다.
5. 사용 중지된 헬퍼를 사용하고 있다면 이 정보를 참조하여 헬퍼를 지원되는 것으로 바꾸세요.

   다시 테마를 미리 보고 더 이상의 경고가 없도록 확인하세요.

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

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