GitHub 연동 서비스를 사용하면 GitHub에서 공동 작업으로 테마를 개발하고 유지한 후 Guide에서 테마를 미리 보거나 게시할 수 있습니다. 연동 서비스를 설정하려면 반드시 테마가 GitHub에 저장되어 있는지 확인한 다음 Guide에서 연동 서비스를 설정합니다.
Guide에서 GitHub 연동 서비스를 설정하려면 Guide 관리자여야 합니다.
GitHub에서 테마 준비하기
Guide에서 연동 서비스를 설정하기 전에 테마가 GitHub에 있는지 확인해야 합니다. Git 및 GitHub를 처음 사용하는 경우에는 이 튜토리얼을 확인해 보세요. 테마가 이미 GitHub에 있고 다음 요구 사항을 만족하는 경우에는 Guide에서 연동 서비스 설정하기를 참조하세요.
연동 서비스를 위해 GitHub 저장소에 대한 다음과 같은 요구 사항이 있습니다.
-
GitHub 저장소의 루트에 매니페스트 파일이 있어야 합니다.
Guide에서 테마를 추가하려면 GitHub 저장소의 루트에 manifest.json 파일이 있어야 합니다. Guide에 가져올 때 무시되는 도구와 같은 추가 파일을 여전히 포함할 수 있습니다.
-
GitHub 저장소에는 하나의 테마만 있을 수 있습니다.
각 저장소에서 하나의 테마만 관리할 수 있습니다. 테마 가져오기 중 브랜치 옵션을 사용하여 테마의 변형을 사용해 볼 수 있습니다.
GitHub 저장소에 테마를 가져오려면 다음과 같이 하세요.
- 현재 테마가 없는 경우에는 Copenhagen 테마 저장소를 분기하고 테마 구축을 시작할 수 있습니다. 이로써 Copenhagen 테마의 개선 사항을 쉽게 향후 테마에 포팅할 수 있습니다.
- 테마가 Guide에 있는 경우에는 Guide에서 테마를 다운로드한 후 GitHub 저장소를 만들어(아직 없는 경우) 테마를 GitHub 저장소에 푸시할 수 있습니다.
- 테마가 Guide나 GitHub에 없는 경우에는 GitHub 저장소를 만들어(아직 없는 경우) 테마를 GitHub 저장소에 푸시할 수 있습니다.
GitHub에 테마를 준비한 후에는 Guide에서 연동 서비스를 설정할 준비가 된 것입니다.
연동 서비스 설정하기
GitHub 연동 서비스를 설정하려면 반드시 테마가 GitHub에 저장되어 있는지 확인한 다음 GitHub에서 Guide로 테마를 가져올 수 있습니다. 이 일회성 가져오기는 테마와 GitHub 간의 연결을 설정합니다.
연동 서비스를 설정한 후에는 GitHub에서 테마 작업을 한 후 준비가 되면 Guide에서 테마를 업데이트합니다. Guide에서 실시간으로 테마를 미리 보거나 게시할 수 있습니다.
Guide 테마와 GitHub 연동 서비스를 설정하려면 다음과 같이 하세요.
- GitHub에서 테마를 준비했는지 확인합니다.
- Guide의 사이드바에서 디자인 사용자 지정 아이콘(
)을 클릭합니다.
테마 페이지가 열립니다.
- 오른쪽 위에 있는 테마 추가를 클릭합니다.
-
GitHub에서 추가를 클릭합니다.
- 저장소의 URL을 입력하고, 기본 브랜치가 아닌 다른 브랜치에서 가져오려면 브랜치 이름을 입력(선택 사항)한 다음 가져오기를 클릭합니다.
- 메시지가 표시되면 GitHub에 로그인한 다음 Zendesk 권한 부여를 클릭합니다.
가져오기가 완료되면 테마 페이지에 테마 축소판 이미지가 나타납니다. 문제가 있으면 Guide 테마용 GitHub 연동 서비스 문제 해결하기를 참조하세요.
Guide와 GitHub의 테마 간에 연결을 설정한 후에는 GitHub에서 테마를 관리하고 필요에 따라 Guide에서 테마를 업데이트합니다.