三步打造本身的gitbook電子書

前言

學習一門技術，咱們能夠寫本電子書來對整個知識體系進行梳理，進而加深理解和記憶。

第一步，安裝 node npm

# 查看 node 版本
node -v

# 查看 npm 版本
npm -v
複製代碼

若是成功打印出版本號，說明你本地具有了 node 的運行環境（安裝 node 默認安裝 npm），而若是沒有或報錯，則你須要去 node 官網進行 node 的下載及安裝，如圖：

左邊的版本是推薦安裝的穩定版本，也就是目前已經被正式列入標準的版本，而右邊的版本是當前最新的版本，該版本包含了一些新的特性，還未被徹底列入標準，可能之後會有所變更。這裏建議你們安裝最新的 node 穩定版進行開發。

建議使用 npm 淘寶源：

npm config set registry https://registry.npm.taobao.org/
複製代碼

第二步，全局安裝 gitbook-cli

npm i -g gitbook-cli
複製代碼

第三步，初始化電子書

# 建立一個目錄，進入
mkdir gitbook-demo
cd gitbook-demo

# 初始化電子書目錄
gitbook init 

# 編譯電子書
gitbook serve 
複製代碼

說明一下：

init 之後，目錄裏會有這兩個文件 README.md 和 SUMMARY.md，README.md 是對電子書的簡單介紹，SUMMARY.md 是電子書的目錄結構。

目錄結構長這樣：

* [電子書名稱](README.md)
* [第一章](chapter1/README.md)
    * [xxxx](chapter1/section1.1.md)
    * [xxxx](chapter1/section1.2.md)
* [第二章](chapter2/README.md)
    * [xxxx](chapter2/section2.1.md)
    * [xxxx](chapter2/section2.2.md)
複製代碼

編寫 SUMMARY.md，執行 gitbook init 生成目錄結構文件，而後編寫各個文件夾中生成的文件。

最後 gitbook serve。

gitbook serve 命令實際上會首先調用 gitbook build 編譯書籍，完成之後會打開一個 web 服務器，監聽在本地的 4000 端口。

小拓展

你能夠將電子書提交到 github，在託管電子書的倉庫建一個 gh-pages 分支，將本地編譯好的電子書文件（項目根目錄下的 _book 目錄裏的文件 ）上傳到這個分支，而後就可使用這個網址訪問 http://yourUserName.github.io/bookName。

固然也能夠發佈到gitbook，然而這個網站訪問有點慢-.-

talking

製做電子書的工具還有不少，你們不妨在討論區，談一下本身經常使用的工具^0^

附上本身作的電子書網址就更棒啦-。-