GitBook이란 ?
GitBook은 개인이나 팀이 내부 지식을 쉽게 공동 저작물을 문서화 할 수 있게 도와주는 최신 문서 플랫폼이다.
주로 기업에서는 사용 설명서 정도로 많이 활용을 하고, 팀 단위로 내부 지식공유에도 많이 활용된다. 요즘엔 개인들이 자신이 배운 내용(TIL)들을 기록하는 용도로도 종종 만나볼 수 있다.
필자의 경우도 Git 블로그에 포스팅하면서 생겼던 고민이 배웠던 개념을 정리한 내용과 실습했던 내용에 대한 구분을 두고 싶었다. 카테고리 기능을 추가하여 해결하려던 찰나에 GitBook이라는 툴을 발견하여 앞으로 개념 정리 관련된 내용은 Gitbook에 정리할 생각이다.
특징
- GitHub 연동 기능
- 공동 수정을 위한 Draft 기능
- 팀 관리 기능으로 접근 권한 제어 기능
- 마크다운 및 이모지 기능
- 페이지와 그룹을 통한 문서 구조화 기능
- 코드 블럭, 테이블, 힌트 탭 지원
활용사례
사용법
1.GitBook에 회원가입 한다.
- GitHub 계정을 이용한 간편 회원가입을 지원한다.
2.Create a new space를 눌러 첫 Space를 생성한다.
- Space는 GitBook의 책 제목과 같은 격
3.New 버튼으로 새로운 Page, Group 등을 생성할 수 있다.
4.다양한 소스로부터 import 기능도 지원한다.
- Google Docs
- Github Wiki
- Dropbox Paper
- Notion
5.팀으로 활용 시 계정별 수정 로그가 남아 이력 관리가 가능하다.
6.GitHub의 특정 Repository와 연동이 가능하다. 즉, GitHub와 GitBook 어디에서 문서를 작성하더라도 양방향으로 동시에 반영되어 수정이 될 수 있다.
- TIL을 기록하고자 한다면 GitHub에 그냥 마크다운으로 하는 것보다 보기 쉽게 구조화 할 수 있고, 쉽게 이미지를 삽입할 수 있어 편리한 것 같다.
- GitBook에서 수정 시 GitHub에도 commit으로 반영되므로 잔디심기에도 유용하다.
7.도메인은 기본적으로 https://ID.gitbook.io/Space Name 으로 생성되며, GitHub Page와 같이 커스텀 도메인 기능도 지원하고있다.
댓글 남기기