一散怖、Gitbook是什么
GitBook 是一個(gè)基于 Node.js 的命令行工具，支持 Markdown 和 AsciiDoc 兩種語法格式肄渗，可以輸出 HTML镇眷、PDF、eBook 等格式的電子書翎嫡。所以欠动，GitBook 不是 Markdown 編輯工具，也不是 Git 版本管理工具惑申。
- Markdown編輯器對(duì)比（推薦使用vscode具伍、Typora 、Gitbook官方編輯器）
| 名稱 | 說明 | 平臺(tái) | 是否免費(fèi) |
|---|---|---|---|
| Visual Studio Code | 插件：Paste Image圈驼、Docs Markdown人芽、Markdown Preview Enhanced | Mac OS、Windows绩脆、Linux | 免費(fèi) |
| Typora | 支持實(shí)時(shí)預(yù)覽的 Markdown 文本編輯器 | Mac OS萤厅、Windows橄抹、Linux | 免費(fèi) |
| MacDown | Mac OS | 免費(fèi) | |
| Bear | 筆記應(yīng)用中的瑞士軍刀 | Mac OS 、iPhone惕味、iPad | 免費(fèi)+內(nèi)購 |
| MarkdownPad | Windows下的一個(gè)多功能Markdown編輯器 | Windows | 免費(fèi)+收費(fèi) |
| MarkdownX | Android輕量級(jí)編輯器 | Android | 免費(fèi) |
二楼誓、安裝、使用Gitbook
首先安裝node.js名挥，node版本要求：V4.0.0以上疟羹。按步驟執(zhí)行如下命令
1、通過npm躺同，全局安裝Gitbook 阁猜，執(zhí)行命令npm install gitbook-cli -g
2丸逸、查看是否安裝成功蹋艺，gitbook -V
3、在 mybook 文件夾（初始化）創(chuàng)建一本書gitbook init黄刚，會(huì)自動(dòng)生成兩個(gè)必要的文件 README.md 和 SUMMARY.md捎谨。
README.md —— 書籍的介紹寫在這個(gè)文件里
SUMMARY.md —— 書籍的目錄結(jié)構(gòu)在這里配置
4、預(yù)覽書籍gitbook serve . --port 4200憔维。此時(shí)可以通過http://localhost:4200/預(yù)覽
5涛救、編輯 SUMMARY.md 文件，內(nèi)容修改為：
# Summary
* [簡(jiǎn)介](README.md)
* [1.Docker入門](chapter1/README.md)
* [1.1 什么是Docker](chapter1/section1.md)
* [1.2 Docker基本概念](chapter1/section2.md)
* [1.3 安裝Docker](chapter1/section3.md)
* [1.4 使用Docker鏡像](chapter1/section4.md)
* [1.5 操作容器](chapter1/section5.md)
* [1.6 訪問倉庫](chapter1/section6.md)
* [1.6 數(shù)據(jù)管理](chapter1/section7.md)
* [2.使用Docker部署web應(yīng)用](chapter2/README.md)
* [2.1 編寫DockerFile](chapter2/section1.md)
* [2.2 編寫web應(yīng)用](chapter2/section2.md)
* [2.3 構(gòu)建鏡像](chapter2/section3.md)
* [2.4 運(yùn)行web應(yīng)用](chapter2/section4.md)
* [2.5 分享鏡像](chapter2/section5.md)
* [結(jié)束](end/README.md)
6业扒、在 mybook 文件夾中再次執(zhí)行 gitbook init 命令检吆。GitBook 會(huì)查找 SUMMARY.md 文件中描述的目錄和文件，如果沒有則會(huì)將其創(chuàng)建程储。
7蹭沛、發(fā)布書籍，執(zhí)行
gitbook build命令構(gòu)建書籍章鲤，默認(rèn)將生成的靜態(tài)網(wǎng)站輸出到 _book 目錄摊灭。
gitbook build [書籍路徑] [輸出路徑]
gitbook pdf ./ ./mybook.pdf
gitbook epub ./ ./mybook.epub
gitbook mobi ./ ./mybook.mobi
輔助工具： ebook-convert。 Typora + Pandoc 進(jìn)行導(dǎo)出败徊。
三帚呼、fixbugs
1、用gitbook想生成HTML皱蹦，執(zhí)行了gitbook serve時(shí)報(bào)錯(cuò)：Error: ENOENT: no such file or directory, stat 'C:UserscjfGitBookLibraryImportprepare_bookgitbookgitbook-plugin-fontsettingsfontsettings.js'
在book目錄下煤杀，如下代碼新建book.json，將如下代碼copy&paste沪哺。保存文件后沈自，運(yùn)行gitbook install安裝插件依賴。重新執(zhí)行gitbook serve
{
"plugins": [
"fontsettings",
"sharing",
"lunr",
"search",
"highlight",
"livereload"
]
}
其他辦法：我使用gitbook serve遇到同樣的問題凤粗，改為 gitbook serve .\ 就OK了酥泛。我是win10平臺(tái)今豆，gitbook 3.2.3
參考地址：
1、http://www.lijiam.com/part2/gitbook/install.html
2柔袁、https://www.cnblogs.com/xiaoqi/p/8194350.html
