GitBook 메모

사용법

• Save 후 Merge 까지 해야 https://justburrow.gitbook.io/street-cat-study에서 확인할 수 있다.

  • GitHub 연동을 시켜놓고 보니, Merge는 squash 같아 보인다. 이건 GitBook에서 GitHub 쪽으로 동기화 할때만 그럴지도.

• GitBook에서 직접 클론할 수 있는 방법은 없고, GitHub와 연동해야 하는 듯. https://github.com/JustBurrow/street-cat-study

  • GitHub 연동하면 연동한 프로젝트의 wiki와 연동되는 건가 했는데, 코드 저장소와 연동된다.

• 기본적으로 GitHub wiki의 파일 구성을 따르는 듯. 디렉토리는 사용 불가?

장점

1. Notion과 유사한 사용자 경험.

2. 커밋 메시지를 생각하지 않아도 된다.

단점

1. 새 블록을 추가했을 때, 첫 글자를 입력하면 블록이 포커스를 잃어버린다. macOS + Chrome + Google IME

2. 리스트에 하위 리스트를 추가했을 때, 종류를 바꿀 수 없다. 상위 Bulleted List + 하위 Ordered List 같은 구성이 에디터에서 불가능.

3. GitHub 연동했을 때, GitBook에서 제목이 한글인 페이지는 undefined.md 혹은 undefined-1.md 같은 식으로 마크다운 파일이 생긴다.

   1. 언어 설정이 가능하던데 영어가 아닌 언어도 이렇게 되나?

4. GitHub와 동기화를 하더라도 GitHub에서 수정하더라도 GitBook에 반영되지 않는다.

   1. 단순히 시간이 걸려서 반영되지 않은 것일 수도 있음.