깃북(01) - 깃북 살펴보기

깃북이라는 서비스가 있다.

https://www.gitbook.com/

GitBook - Where technical teams document.

기술 문서를 작성할 수 있는 서비스인데 마크다운으로 책을 작성할 수 있다.

팀 기능이나 내보내기 같은 기능은 유료로 제공하고 있다.

 

이거랑 비슷한 서비스 중에 한국에는 위키독스라는게 있다.

무료로 책을 만들고 공유할 수 있는 서비스지만 작성한 내용은 퍼블릭하게 오픈되어야 한다.

https://wikidocs.net/

위키독스

 

개발 필요성

일단 이렇게 온라인으로 책을 작성할 수 있는 도구가 필요했다.

기존에 회사에서 워드나 피피티로 문서를 작성하고 공유, 버전관리하는게 있어서 불편한 면이 많았다.

원노트에 써서 공유하는것도 좀... 불편한 면이 있고

노션도 마찬가지로 팀으로 쓰려면 무료 버전에서는 용량 제한이 심하다. 거의 체험판 수준

유료로 쓰기에는 회사 일 하려고 하는건데 내돈을 쓰는게 말이 안되고... 회사에 이런거 쓰자고 하는것도 안먹힐거 같고

그냥 만들어보자! 라고 결론이 났다.

 

회사 자료를 외부 서비스에 작성하는것도 문제가 되는 부분이다.

 

요구사항

• 회사 별로 권한 관리가 가능해야 한다.
• 마크다운 에디터로 편집이 가능해야 한다.
• 접근 제어가 되고 쉽게 공유가 가능해야 한다.
• 내보내기 기능이 필요하다. 내보내기 포맷은 PDF, WORD, 마크다운 등

먼저  GPT한테 이것저것 물어봤는데

• 무료로 사용가능한 마크다운 에디터가 있는지 문의했다. 있었다.
• 깃헙 API로 리포지토리 생성이 가능한지, 커밋하고, 접근 제어하고, 데이터를 불러오고 할 수 있는지 확인
• 게다가 Organization에 따른 권한 접근 제어도 가능하다고 한다.
• 내보내기도 pandoc 이라는 오픈소스가 있는것으로 확인됐다.

특징

• 자료의 주권이 작성자에게 있도록 하는것이 목적이다.
• 깃헙 로그인으로 접속하여 책을 만들면 자기 계정에 리포지토리가 생성된다.
• 데이터를 깃헙에 저장하여 버전 관리 기능, 문서 저장 관리등은 깃헙에 맡김
• 언제든지 꺼내고 넣을 수 있음
• 우리 서비스를 거치지 않더라도 원본은 확인이 가능