GitBook과 Github저장소 연동하기

 

안녕하세요 아렉스입니다.

GitBook이란, 공식문서에 따르면 제품에서 내부 지식 기반 및 API에 이르기까지 모든 것을 문서화 할 수 있는 최신 문서 플랫폼 이라고 한다.

Obsidian을 통해서 정리한 마크다운 문서들을 Publish 하기 위해 사용하려고합니다

그동안 정리 참 많이해뒀네요 !

 

🚪Github저장소와 연동하는 방법

연동하는 방법은 매우 간단해요

1. GitBook에 들어가 로그인 한 후 대시보드에 진입합니다.
2. 아래와 같이 왼쪽 상단에 있는 플러스 버튼을 클릭해 New Space를 생성합니다.

 

3. New Space를 통해 생성 된 페이지 오른쪽 상단에 있는 버튼을 클릭해 Synchronize With Git 메뉴로 진입

 

4. Intergrations 메뉴로 이동, Github Sync 설치 및 활성화를 시켜줍니다.

 

5. Configuration 탭 이동, Connect with Github를 버튼을 눌러 계정과 연결 해줍니다.

 

 

모든 레포지터리에 액세스 권한을 주고싶진않아서, Gitbook으로 Publish 할 Document 레포만 선택해주었습니다.

6. Install 버튼을 눌러줍니다.

 

 

여기까지 따라왔다면, Authenticate는 Connected, Account에는 본인의 계정이 보일거에요

 

 

7. 계정을 설정하게 되면, Gitbook에 필요한 몇몇 설정들을 마무리하고 sync 버튼 클릭

 

 

Spaces를 떠나 Docs sites로 전환해서 Publish 버튼 눌러주면 끝 !