參考文章：GitBook 從懵逼到入門
一、介紹
GitBook 是一個(gè)基于 Node.js 的命令行工具，可使用 Github/Git 和 Markdown來(lái)制作精美的電子書(shū)，GitBook 并非關(guān)于 [Git]的教程。
-
GitBook + Markdown + Git優(yōu)點(diǎn)：- 語(yǔ)法簡(jiǎn)單
- 兼容性強(qiáng)
- 導(dǎo)出方便
- 專注內(nèi)容
- 團(tuán)隊(duì)協(xié)作
注：本文使用搭配：GitBook + Typora + Git
-
相關(guān)markdown編輯器：
markdown編輯器
二、安裝
- 全局安裝
gitbook-cli
npm i -g gitbook-cli
2、安裝軟件：Git、Typora
百度網(wǎng)盤 提取碼：aljw
三、使用
- 新建mybook文件夾，初始化：
gitbook init
gitbook init
README.md —— 書(shū)籍的介紹寫(xiě)在這個(gè)文件里
SUMMARY.md —— 書(shū)籍的目錄結(jié)構(gòu)在這里配置
-
啟動(dòng)Typora編輯器，引入文件夾
Typora打開(kāi)mybook 編輯
SUMMARY.md
# 目錄
* [前言](README.md)
* [第一章](Chapter1/README.md)
* [第1節(jié)：衣](Chapter1/衣.md)
* [第2節(jié)：食](Chapter1/食.md)
* [第3節(jié)：住](Chapter1/住.md)
* [第4節(jié)：行](Chapter1/行.md)
* [第二章](Chapter2/README.md)
* [第三章](Chapter3/README.md)
* [第四章](Chapter4/README.md)
-
再次執(zhí)行
gitbook init，生成新目錄結(jié)構(gòu)
gitbook init
新目錄 -
瀏覽器瀏覽：
gitbook serve
執(zhí)行gitbook serve來(lái)預(yù)覽這本書(shū)籍，執(zhí)行命令后會(huì)對(duì) Markdown 格式的文檔進(jìn)行轉(zhuǎn)換，默認(rèn)轉(zhuǎn)換為 html 格式，最后提示 “Serving book on http://localhost:4000”
gitbook serve 構(gòu)建書(shū)籍：
gitbook build
默認(rèn)：將生成的靜態(tài)網(wǎng)站輸出到 _book 目錄
指定路徑：gitbook build [書(shū)籍路徑] [輸出路徑]
指定端口：gitbook serve --port 2333
生成pdf格式：gitbook pdf ./ ./mybook.pdf
生成epub格式：gitbook epub ./ ./mybook.epub
生成 mobi 格式：gitbook mobi ./ ./mybook.mobi
注意：如果生成不了，你可能還需要安裝一些工具，比如 calibre、ebook-convert，或者在 Typora 中安裝 Pandoc 進(jìn)行導(dǎo)出。
四、用 Git 做版本管理
在遠(yuǎn)端建好git倉(cāng)庫(kù)，在 mybook 目錄下執(zhí)行 git init 初始化倉(cāng)庫(kù)，執(zhí)行 git remote add 添加遠(yuǎn)程倉(cāng)庫(kù)。接著就可以愉快地 commit，push，pull …
