gitbook使用gitbook命令來(lái)制作當(dāng)?shù)匚募夸浐臀募?并可用localhost瀏覽效果)悼尾,使用git進(jìn)行版本管理和上傳同步到gitbook.com網(wǎng)站上(目前不支持ssh方式),使用calibre進(jìn)行pdf書(shū)籍制作肖方。
1.安裝gitbook
# 若沒(méi)有安裝npm則先安裝npm
$ npm install -g gitbook-cli
$ gitbook -V
2.簡(jiǎn)單使用gitbook命令
$ gitbook init # 建立README.md和SUMMARY.md文件
# 編輯SUMMARY.md文件闺魏,示例文件如下
* [簡(jiǎn)介](README.md)
* [第一章](chapter1/README.md)
- [第一節(jié)](chapter1/section1.md)
- [第二節(jié)](chapter1/section2.md)
* [第二章](chapter2/README.md)
- [第一節(jié)](chapter2/section1.md)
- [第二節(jié)](chapter2/section2.md)
* [結(jié)束](end/README.md)
$ gitbook init #生成對(duì)應(yīng)的目錄和文件
$ gitbook serve . #可以使用localhost預(yù)覽
$ gtibook build #_book文件夾下是完整的靜態(tài)網(wǎng)頁(yè)html
$ gitbook pdf . #生成pdf,要先安裝calibre工具俯画,并把/Applications/calibre.app/Contents/MacOS添加到path路徑
3.使用git命令將當(dāng)前文件夾同步到gitbook.com網(wǎng)站上
# 這一步和github同步文件夾的步驟類(lèi)似析桥,但是不能用ssh上傳,也就是說(shuō)不能免密碼登陸
$ git clone https://name/your.project.git # 從gitbook上clone
# 用gitbook等方式編輯文件和文件目錄
$ git add .
$ git commit -m "commit"
$ git push