#02 GitBook 설치하기

1. 사전 준비 사항

• Linux OS 준비
• Windows 의 경우 wsl(Windows Subsystem for Linux) 또는 wsl2 준비
• OS 내 npm(Node Package Manager) 준비

   

  도커 환경 셋팅

   

Docker + ubuntu + gitbook 셋팅

 

2. 설치 명령어 실행

• GitBook를 설치 하는 가장 좋은 방법은 NPM을 이용하는 방법 입니다. 터미널 프롬프트에서 다음 명령을 실행해 GitBook를 설치만 하면 됩니다.

$ npm install gitbook-cli -g

gitbook-cli 동일한 시스템에 여러 버전의 GitBook을 설치하고 사용하는 유틸리티 입니다. 필요한 GitBook 버전을 자동으로 설치 합니다.

3. GitBook 생성

$ gitbook init {path}
# 신규 디렉터리 자동 생성 후 적용
# gitbook init ./first_tutorial

# 현재 프롬프트 경로 내 적용
$ gitbook init

4. 기본 셋팅 구조

.
├── book.json # 기본 GitBook구성 데이터(선택-생성 필요)
├── README.md # 서적 소개(필수)
├── SUMMARY.md # 목차(선택)
├── part1/
| ├── README.md
| └── writing.md
└── part2/
├── README.md
└── writing.md

5. localhost 사전셋팅 방법

# 아래 명령어 실행시 http://localhost:4000 으로 사전 테스트 가능
# cd ./first_tutorial
$ cd {path}

$ gitbook serve

---

* docker-compose 셋팅

GitHub - dev-truly/docker_gitbook_app

 

---

기타 참고 사항

정적 페이지 생성

$ gitbook build

테스트 버전 설치

gitbook-cli으로 테스트 하기 위해 GitBook의 다른 버전을 쉽게 다운로드 하고 셋팅이 가능 합니다.

$ gitbook fetch beta
# gitbook ls-remote 설치 가능 한 원격 버전 조회

디버깅

--log=debug, --debug 옵션을 활용, 오류 메시지를 얻을 수 있습니다.(스택 추적 포함)

$ gitbook build ./ --log=debug --debug