• GitBook 개요
• 폴더 구조

GitBook 개요

---

• https://github.com/GitbookIO/gitbook

• https://github.com/GitbookIO/gitbook/tree/master/docs

• https://www.npmjs.com/package/gitbook

• https://docs.gitbook.com/

  • https://docs.gitbook.com/v2-changes/important-differences#plugins

• Plugin Sample : https://github.com/GitbookIO/plugin

• install/bin/installManual.bash 파일을 참조할 것

• book.json의 variables에 선언된 변수 사용법 : {{book.variable}}

  • {% if book.variable == "scada.obcon.biz" %}

  • {% else %}

  • {% endif %}

문서 생성

#--- 현재 Windows에서만 정상 동작
#---     Linux에서는 calibre 설치 필요
cd  /work/appl/obcon_scada/manual/scada
gitbook  pdf   ./  ./_build/scada.pdf
gitbook  epub  ./  ./_build/scada.epub
gitbook  mobi  ./  ./_build/scada.mobi

#--- 현재 Linux에서만 정상 동작
#---     Latex(PC)/texlive(Linux) 패키지 설치 필요
cd  /work/appl/obcon_scada/manual/scada
/bin/pandoc  --smart  --output=./_build/scada.docx  ./README.md  ./SUMMARY.md
/bin/pandoc  --smart  --output=./_build/scada.docx  *.md

GitBook 명령어 사용법

gitbook  help
gitbook  ls
# gitbook  update

#--- Plugin 설치
cd  /work/appl/obcon_scada/manual/scada
gitbook  install

#--- GitBook Web Service 실행
gitbook  serve
gitbook  serve  --port  4000

폴더 구조

---

• .bookignore : GitBook의 관리에서 제외할 파일/폴더 지정

• book.json : GitBook 구성 파일

• README.md : 서적 소개 (필수)

• SUMMARY.md : 메뉴 구조 (필수)

• GLOSSARY.md : 용어 설명

• LANGS.md : 다국어 지원

---