揭秘Gitbook：電子書制作神器，讓你的知識分享更精彩！
內容源于藍橋云課社區(qū)-輕實驗，可在線開啟環(huán)境實操
你是不是有很多 MarkDown 的學習筆記需要整理？你心中是不是有一個作家夢？
本次，我將介紹如何借助 GitBook ，將 MarkDown 類型的文檔編輯成一本在線的開源電子書，方便隨時隨地查閱。
GitBook 是一個基于 Node.js 的命令行工具，可使用 Github/Git 和 Markdown 來制作精美的電子書，GitBook 和 Git 并無直接關聯。
GitBook 生成電子書主要有三種方式:
gitbook-cli?命令行操作，簡潔高效，適合從事軟件開發(fā)的相關人員
gitbook-editor?編輯器操作，可視化編輯，適合無編程經驗的文學創(chuàng)作者
gitbook.com?官網操作，在線編輯實時發(fā)布，適合無本地環(huán)境且科學上網的體驗者
GitBook?支持輸出多種文檔格式：
靜態(tài)站點：GitBook 默認輸出該種格式，生成的靜態(tài)站點可直接托管搭載 Github Pages 服務上；
PDF：需要安裝 gitbook-pdf 依賴；
eBook：需要安裝 ebook-convert；
單 HTML 網頁：支持將內容輸出為單頁的 HTML，不過一般用在將電子書格式轉換為 PDF 或 eBook 的中間過程；
JSON：一般用于電子書的調試或元數據提取。
本次實驗主要講解第一種 gitbook-cli 命令行操作流程。
常用 GitBook 命令
1.安裝 gitbook-cli 腳手架工具
本機已安裝 node.js 開發(fā)環(huán)境，安裝完成后運行 gitbook -V 能夠打印出版本信息，則表示安裝成功。
運行時會報如下錯誤：
原因是容器中默認安裝的 node 版本過高，需要先卸載容器中高版本的 npm ：
再安裝低版本的：
2.初始化 gitbook 項目
此處初始化需要一點點時間 ，請耐心等待。
使用 GitBook 制作電子書，必備兩個文件：README.md 和 SUMMARY.md。通過初始化 gitbook 項目即可按照 gitbook 規(guī)范自動創(chuàng)建 README.md 和 SUMMARY.md 兩個文件，這兩種的作用在下文介紹。
3.啟動 gitbook 項目
在執(zhí)行 gitbook init 命令的目錄下啟動本地服務，通過 port 指定端口，如果不指定，默認為 4000。
程序無報錯，則可以在瀏覽器預覽電子書呈現效果:
4.構建 gitbook 靜態(tài)網頁
構建靜態(tài)網頁而不啟動本地服務器，默認生成文件存放在 _book/ 目錄，當然輸出目錄是可配置的。
GitBook 的目錄結構說明
既然要書寫一本電子書，那么起碼的章節(jié)介紹和章節(jié)詳情自然是必不可少的。
當然還要有標題，作者和聯系方式等個性化信息需要指定，如果不指定的話，使用默認設置就會出現上圖中的效果，所以配置文件一般需要手動設置！
首先簡單解釋下上圖中各個文件的作用:
README.md 是默認首頁文件，相當于網站的首頁 index.html , 一般是介紹文字或相關導航鏈接。
SUMMARY.md 是默認概括文件，主要是根據該文件內容生成相應的目錄結構，同 README.md 一樣都是被 gitbook init 初始化默認創(chuàng)建的重要文件。
_book 是默認的輸出目錄，存放著原始 markdown 渲染完畢后的 html 文件，可以直接打包到服務器充當靜態(tài)網站使用。
一般是執(zhí)行 gitbook build 或 gitbook serve 自動生成的。
book.json 是配置文件，用于個性化調整 gitbook 的相關配置，如定義電子書的標題，封面，作者等信息。
雖然是手動創(chuàng)建，但一般是必選的。
GLOSSARY.md 是默認的詞匯表，主要說明專業(yè)詞匯的詳細解釋，這樣閱讀到專業(yè)詞匯時就會有相應提示信息，也是手動創(chuàng)建但是可選的。
LANGS.md 是默認的語言文件，用于國際化版本翻譯，和 GLOSSARY.md 一樣是手動創(chuàng)建但是可選的。
在線部署
開發(fā)到一定程度后打算發(fā)布服務，再運行 gitbook build 輸出到 _book/ 目錄。
別忘了配置 book.json 文件，然后就可以將 _book/ 文件夾整個扔到 nginx 等靜態(tài)服務器上，這樣就能聯網訪問你的電子書了。
示例如下：
1.編寫素材
a.md 內容如下
b.md 內容如下
2.編寫 book.json，存放配置信息
3.編寫 README.md ，添加如下內容簡介
4.編寫 SUMMARY.md 配置章節(jié)目錄
5.生成圖書并訪問
效果如下：
圖中紅色區(qū)域的地址可以在生成的 index.html 中進行相應的修改。
也可以使用 gitbook build 生成文件再部署到 WEB 服務器。快去試試吧！
好了，今天的內容就分享到這里了。
如果你想了解更多技術干貨，歡迎關注～
