在經過了長時間的折騰之后，終于在Mac環境成功的安裝了Gitbook。

安裝Gitbook的主要流程如下：

安裝node.js>安裝Gitbook>安裝Gitbook編輯器>安裝calibre>導出PDF。

1. 安裝node.js

安裝node.js，在node.js官網下載，直接安裝。

下載地址：https://nodejs.org/en/。

這里需要注意的是，node.js有兩個版本，一個是大多數人使用的，也就是穩定版；另一個是最新版，擁有最新的特性。在這里，我們下載穩定版即可。

安裝成功之后輸入node -v，顯示node.js版本代表安裝成功。

huixingdeMacBook-Air:~ huixing$ node -v
v6.10.2

2. 安裝Gitbook

這個點是最坑的。尤其是在Mac環境下，我先后嘗試了以下代碼：

npm install gitbook -g
npm install -g gitbook-cli

還有好幾個，先說明下，以上代碼都是錯誤的，不是卡主了就是不能動。原來，Mac環境下需要用到sudo這個指令。

sudo npm install gitbook-cli -g

一定要用到-g，這個代表全局安裝，我去掉-g安裝了一次，也成功了，但是在終端使用gitbook -V查看的時候發現根本沒安裝，這是我遇到的坑最多的地方。

在終端輸入gitbook -V之后即可查看當前Gitbook版本，代表安裝成功。需要注意的是“V”一定要大寫。

huixingdeMacBook-Air:~ huixing$ gitbook -V
CLI version: 2.3.0
GitBook version: 3.2.2

3. 安裝Gitbook編輯器

接下來就是安裝Gitbook桌面編輯器了。有的人可能會問，你都已經安裝了終端環境下的Gitbook了，為什么還要安裝桌面端呢？

下載地址：https://www.gitbook.com/editor/（已不可用）
新下載地址（2018-11-30更新）：https://legacy.gitbook.com/editor/osx

其實，使用Gitbook桌面編輯器能夠很方便的進行文章書寫，終端環境下的Gitbook只是為了生成HTML文檔與PDF文檔而使用的。

安裝了Gitbook桌面端之后，你可以在客戶端中新建一本書籍。然后用終端生成HTML。

使用gitbook build命令。

huixingdeMacBook-Air:import huixing$ cd jianli
huixingdeMacBook-Air:jianli huixing$ gitbook build
info: 7 plugins are installed 
info: 6 explicitly listed 
info: loading plugin "highlight"... OK 
info: loading plugin "search"... OK 
info: loading plugin "lunr"... OK 
info: loading plugin "sharing"... OK 
info: loading plugin "fontsettings"... OK 
info: loading plugin "theme-default"... OK 
info: found 1 pages 
info: found 7 asset files 
info: >> generation finished with success in 1.0s ! 
huixingdeMacBook-Air:jianli huixing$ 

看到success的提示沒，這個時候系統文件根目錄下就生成了一個_book的文件夾。打開就是該書籍的HTML格式了。

你也可以直接將該書籍在本地預覽。

使用gitbook serve命令

huixingdeMacBook-Air:jianli huixing$ gitbook serve
Live reload server started on port: 35729
Press CTRL+C to quit ...

info: 7 plugins are installed 
info: loading plugin "livereload"... OK 
info: loading plugin "highlight"... OK 
info: loading plugin "search"... OK 
info: loading plugin "lunr"... OK 
info: loading plugin "sharing"... OK 
info: loading plugin "fontsettings"... OK 
info: loading plugin "theme-default"... OK 
info: found 1 pages 
info: found 7 asset files 
info: >> generation finished with success in 1.2s ! 

Starting server ...
Serving book on http://localhost:4000

Gitbook編輯器需要同終端里安裝的Gitbook配合，完美實現在線HTML的生成，PDF的生成。當然，如果愿意將文檔公開到gitbook或者gitbub倉庫的看到這里就可以了，因為Gitbook網站上可以直接導出PDF，MOBI，EBUP等電子書格式。如果不想將書籍公開，那么可以往下面繼續看了！

4. 安裝calibre插件

玩過kindle的都知道，calibre是一款非常方便的開源電子書轉換軟件。在這里，我們也是用到ebook-convert這個插件。

首先在calibre官網下載插件，下載鏈接：https://calibre-ebook.com/download。下載適合自己系統的版本。

下載到電腦之后我做了很多嘗試，剛下載之后我興沖沖的去使用gitbook pdf . mypdf.pdf指令，結果發現提示ebook-convert未安裝。

這里我通過咨詢了一些大神，在這個過程中他們給了我很大的幫助。也查看了很多教程，所有教程中都說了兩個問題。

• 將安裝的calibre放在系統應用中，然后將app添加到path中。

  這個說實話我也沒怎么看懂，但是下面我會詳細的說這一步如何操作。

• 執行一個命令sudo ln -s /Applications/calibre.app/Contents/MacOS/ebook-convert /usr/local/bin。

以上兩部我都做了，最終也成功的將Gitbook導出了PDF，但具體是哪一步起了作用，我估計是第二步，不過在教程中我優先推薦使用第二步。第二步遇到的坑是，在網上我們找到的教程只是輸入ln -s /Applications/calibre.app/Contents/MacOS/ebook-convert /usr/local/bin，但是執行多次都沒有結果，WIN系統執行這步可能已經正確了。因為Mac環境權限的原因，這里加入sudo重新執行即可。

執行完成之后，重新進入書籍目錄。

huixingdeMacBook-Air:import huixing$ cd jianli
huixingdeMacBook-Air:jianli huixing$ gitbook pdf . jianli.pdf
info: 7 plugins are installed 
info: 6 explicitly listed 
info: loading plugin "highlight"... OK 
info: loading plugin "search"... OK 
info: loading plugin "lunr"... OK 
info: loading plugin "sharing"... OK 
info: loading plugin "fontsettings"... OK 
info: loading plugin "theme-default"... OK 
info: found 1 pages 
info: found 7 asset files 
info: >> generation finished with success in 7.5s ! 
info: >> 1 file(s) generated 

執行完以上代碼，進入書籍目錄，即可看到已經轉換完成的PDF了。大功告成！

特別感謝：Dandy，煙頭γ兩位大神的指導。