GitBook으로 작성된 [UNIERP 가이드] 설치방법
1. node.js 설치
프로젝트에 따라서 Node의 버전을 어려개 설치하고, 번갈아 가면서 사용해야 할 경우가 있습니다.
그래서 nvm(node version manager)을 이용해서 원하는 node 버전을 골라서 사용할수 있습니다.
NVM 설치 ( node.js 설치 )
nvm 설치주소 : https://github.com/coreybutler/nvm-windows/releases
nvm-setup.zip 파일을 다운로드 후 압축풀어 설치 후 아래 명령어를 차례대로 입력합니다.
windows command 명령어
nvm list available rem 사용가능한 node.js 리스트를 보여준다.
nvm install 16.14.2 rem LTS 짝수버전을 선택한다.
nvm use 16.14.2 rem 16.14.2 node.js 버전을 사용한다.
node --version rem 설치된 node 버전 확인
2. VS Code 설치
3. gitbook 설치
mkdir my-gitbook
cd my-gitbook rem gitbook을 설치할 폴더 생성후 이동
npm install gitbook-cli -g rem gitbook-cli 글로벌 설치 명령
gitbook -V rem gitbook 버전보기하면 설치 시작, ver 3.2.3
gitbook init rem 책 초기화
gitbook serve rem gitbook 시작
gitbook을 설치하면 gitbook의 종속된 graceful-fs에서 오류 발생이 됩니다.
graceful-fs의 최신버전에서는 해결이 됐으나 gitbook 참조버전이 예전버전이라 오류가 발생합니다.
아래 글로벌 gitbook-cli 폴더 위치에 수정된 파일을 덮어 씁니다.
복사 :
현재 패키지에 Patch\graceful-fs-4.2.9\polyfills.js
붙여넣기 :
C:\Users\user\AppData\Roaming\npm\
node_modules\gitbook-cli\node_modules\npm\node_modules\graceful-fs\polyfills.js
정상적으로 gitbook이 시작되면 http://localhost:4000(예) 사이트가 시작됩니다.
4. 출력물 변환(PDF/EPUB)
Windows 패키지관리자에서 calibre 설치후 PDF 변황
winget install calibre --exact rem calibre 설치
gitbook pdf ./ ./mybook.pdf rem mybook.pdf로 출력
gitbook epub ./ ./mybook.epub rem mybook.epub로 출력
gitbook mobi ./ ./mybook.mobi rem mybook.mobi로 출력
5. Pandoc 설치
ms word 형식(.docx)으로 빌드가능한 Pandoc 설치
winget install pandoc rem pandoc 설치
pandoc --version rem pandoc.exe 2.17.1.1
cd _draft rem Markdown 파일이 위치한경로를 기준으로 동작
예)
pandoc -f markdown -t docx -s -o ./_build/javascript.docx ./_draft/archive/study/dev/javascript.md
pandoc 옵션:
-f : from 원본 소스의 포맷(html, json, markdown, docx등)
-t : to 변환할 포맷(html, json, markdown, docx등)
-s : standalone
-o : output 출력 파일 이름