迫使我想在本地查看GitHub文檔的原因
- 希望能離線看GitHub的書籍(我不能保證我每天24小時都有網絡)
- 使用Typora等markdown軟件查看的時候打開章節會彈多一個窗口，個人希望是一個窗口，且可返回，目前我未發現能滿足這個需求的markdown軟件
注意：
因各地網絡原因，某些命令的安裝可能會失敗，這種情況嘗試多安裝幾次即可。若實在安裝不上，嘗試修改nodejs的源爲淘寶的源，網上有相關的文章，此處不做贅述。再安裝不上，請另想辦法
以Ubuntu爲例
1、安裝calibre
sudo apt install calibre
2、安裝nodejs
sudo apt install nodejs
3、安裝gitbook
sudo npm install gitbook-cli
4、安裝插件到書籍所在的目錄
cd ~/book # 假設書籍clone下來的目錄在~/book
gitbook install # 安裝插件到當前目錄
注：1~4步驟需要聯網，以下步驟不需要聯網
5、開始轉換格式爲pdf
cd ~/book # 假設書籍clone下來的目錄在~/book
gitbook build
gitbook pdf # gitbook epub可以轉換格式爲epub、gitbook mobi可以轉換格式爲mobi
執行完上面的命令後，可看到在當前目錄有個book.pdf
6、若想直接在瀏覽器查看電子書，可使用以下命令
cd ~/book # 假設書籍clone下來的目錄在~/book
gitbook serve . # 此步驟若成功，會輸出結果"Serving book on http://localhost:4000"
執行完上述步驟之後，在瀏覽器打開http://localhost:4000即可訪問書籍，或在瀏覽器打開http://IP:4000,其中 IP是代指指執行命令**gitbook serve .**那臺電腦的IP地址
注：若只需要在瀏覽器查看不需要轉換格式，則進行1、2、3、4、6步驟即可
以Windows爲例
1、安裝nodejs和calibre
2、在cmd命令行安裝gitbook
npm install gitbook-cli
3、其餘步驟跟Ubuntu的4~6步驟相似，不多做贅述，值得注意的是，Windows轉換書籍可能會失敗，若失敗，可以嘗試在Ubuntu中轉換格式
=============== 以下是2020.04.30更新 ===============
因gitbook-cli這個工具實在是太久沒有被維護了，雖然很好用，有些情況實在是不能滿足需求，因此，我換過多種方法在本地看GitHub的書籍，中間還是遇到各種不滿足，
1、在電腦安裝一個gitea，通過把GitHub的書籍上傳到本地的gitea服務器，在git服務器網頁端看，而後發現部分文字會去掉一些空格，看起來就像兩個單詞黏在一起，很是彆扭，且由於我看的大多是編程類的書籍，所以這個問題帶來格外多的困擾
2、使用pandoc轉換書籍的格式，發現無法處理markdown中嵌入的部分html代碼，看起來格外難看，於是又放棄了
3、使用gitlab或者gitee（碼雲），gitlab相對GitHub，速度還是可以的，gitee更是阿里的一個產品，國內使用還是不錯的，如果單純只是嫌棄GitHub太慢了，在這兩個平臺上註冊賬號後在上面看書也是個不錯的選擇
4、若執意想要離線觀看，推薦虛擬機+gitlab（gitlab官方有docker項目，也可以直接使用，但官方提示gitlab docker對windows的支持並不算太好，有些功能無法支持，但本人實際體驗，基本的功能還是能用的 ），搭建一個自己的gitlab服務器，我使用的是CentOS7+gitlab，CentOS選擇最小安裝（還有安裝一個dns服務器用來解析域名），對着gitlab官網給的步驟安裝gitlab服務器即可，我就是採取這種方法（離線的忠實粉絲，畢竟只有離線的時候自己纔有絕對的控制權），因爲centOS最小安裝基本不佔用什麼cpu，裝完gitlab後，整個虛擬機佔用磁盤也就不到4個G，gitlab對代碼的着色也挺不錯的，目前對該方式感到非常舒服~~下圖是部分看書時的截圖
