Guide에서 테마의 파일을 내보내서 원하는 텍스트 편집기에서 오프라인으로 파일 작업을 할 수 있습니다. 변경 내용을 미리 보고 싶을 때마다 파일을 압축하여 Guide에 가져오지 않으려면, Zendesk 앱 도구(ZAT)를 사용하여 로컬에서 웹 브라우저로 각 변경 내용을 미리 볼 수 있습니다. 변경 내용을 미리 보려면 데스크톱 편집기에 테마 파일을 저장하고 브라우저에서 페이지를 새로 고칩니다. 예:
ZAT는 개발자 도구 모음으로 사용자 컴퓨터에서 로컬로 실행되는 웹 서버인 Sinatra를 포함합니다. 미리 보기 모드를 시작하면 백그라운드에서 프로세스가 실행됩니다.
이 문서에서 다루는 주제는 다음과 같습니다.
로컬 테마 미리 보기 설정하기
ZAT를 설치하고 사용하려면 API 액세스를 사용 설정하고 로컬 개발 환경을 설정해야 합니다.
로컬 테마 미리 보기를 설정하려면 다음과 같이 하세요.
- 관리 > 채널 > API로 이동하여 Zendesk Support 계정에서 API 액세스를 사용 설정합니다.
- ZAT를 설치합니다. Zendesk 개발자 문서에서 ZAT 설치 및 사용하기를 참조하세요. 그런 다음 여기로 돌아오세요.
- 컴퓨터의 터미널에서 다음 명령을 실행하여 ZAT를 업데이트합니다.
gem update zendesk_apps_tools
로컬 테마 미리 보기 시작하기
컴퓨터에서 테마 파일 작업을 시작하기 전에 로컬 테마 미리 보기를 시작합니다.
로컬 테마 미리 보기를 시작하려면 다음과 같이 하세요.
- 컴퓨터의 터미널에서 내보내고 압축을 푼 테마 파일이 포함된 폴더로 이동합니다. 예:
cd guide_themes/newlook_theme - 다음 명령을 실행합니다.
zat theme preview - 요청에 따라 Zendesk 하위 도메인, Zendesk Guide에 로그인할 때 사용하는 이메일 및 비밀번호를 입력합니다.
통합 인증(SSO)을 사용하여 Guide에 로그인하면 API 토큰을 사용하여 로그인할 수 있습니다. REST API 문서에서 API 토큰을 참조하세요. ZAT에서 로그인 요청을 하면 사용자 이름으로 {your_email}/token을 입력합니다. 여기서 "/token"은 글자 그대로 "/token"이라고 입력하면 됩니다. API 토큰을 비밀번호로 사용합니다. 예:
Enter your username: jdoe@example.com/token Enter your password: e8Pvy0pvGzE8meUQxWgjIYkjr성공적으로 로그인하면 미리 보기 모드가 시작되어 백그라운드에서 실행됩니다.
- 출력에서 "Ready" URL을 복사하여 Chrome 또는 Firefox 등의 웹 브라우저에 붙여 넣습니다. 브라우저는 혼합된 HTTP 및 HTTPS 콘텐츠를 허용해야 합니다. Safari는 혼합된 콘텐츠를 지원하지 않으며 로컬에서 테마를 미리 볼 수 없습니다.
예에서 "Ready" URL은 https://z3n-example.zendesk.com/hc/admin/local_preview/start입니다.
URL이 테마 미리 보기를 로드합니다.
변경 내용 미리 보기
테마 미리 보기 모드를 시작하면 텍스트 편집기에서 로컬로 테마 파일 작업을 수행할 수 있습니다. 반복 작업을 통해 테마를 개발하고 테스트합니다. 예를 들어 JavaScript에서 일부를 변경하고, 변경 내용을 저장한 후, 브라우저 페이지를 새로 고쳐서 테스트하는 작업을 반복합니다.
변경 내용을 미리 보려면 다음과 같이 하세요.
- 텍스트 편집기에서 편집한 파일을 저장합니다.
- 브라우저에서 페이지를 새로 고칩니다.
마쳤으면 다음 방법 중 하나를 사용하여 미리 보기 모드를 중지할 수 있습니다.
- ZAT를 실행 중인 터미널 세션에서 Ctrl+C를 누릅니다.
- 브라우저의 테마 미리 보기 페이지 위쪽에 있는 미리 보기 닫기 링크를 클릭합니다.
0 댓글
댓글을 남기려면 로그인하세요.