Gitbook初體驗

前言： Document Everything! 這是gitbook的宣傳語，感受很不錯。 gitbook用合做代碼的方式合做寫文檔，固然也能夠我的使用做爲版本控制。markdown語法便可，使用gitbook editor能夠直接添加圖片，我的以爲這個功能很好用。以前在github上寫東西，圖片要先上傳獲取外鏈再添加，很麻煩。
進入正題：

1. 因爲要用npm安裝gitbook，首先要有node環境，mac os下用brew install node，其餘環境各不相同
2. 安裝gitbook npm install -g gitbook-cli / cnpm install -g gitbook-cli
   推薦使用cnpm，npm一是速度慢，二是容易出錯。 我用npm安裝後雖然成功安裝2.3.2但每次init都不過，報下載失敗，關代理也不行，後來看到下載地址是cnpm...

   

   
   安裝成功:

3. cd到目標文件夾路徑下， gitbook init

ex: mac os use tree command
home brew...時間過長

如今就可使用markdown工具寫東西了. 我用的是Typora.
4. 編輯目錄：測試可使用多層嵌套目錄[Sec](Sec/third/forth/fifth/README.md) ， 從新執行init就會更新目錄結構，已生成的文件不會被覆蓋。

5. 寫好後就能夠在本地預覽啦。 gitbook serve

6. 能夠選擇git三連上傳 git init git remote add git push -u origin master 也能夠選擇本地轉換成網頁 gitbook build [文檔路徑] [目標路徑] 或者轉成想要的文件格式 gitbook [目標格式] [文檔路徑] [目標路徑].[目標格式] 須要安裝ebook-convert。
   ex: brew cask install calibre mac os 安裝ebook-convert

使用gitbook editor

支持多帳號綁定，看起來很不錯，比較尷尬的是要求chrome是最新版🙂 這麼巧今天chrome發了新版😂趕忙裝一下

在經歷各類bug （github受權失敗，帳號重置密碼失敗等。。）對比mac app和web，我以爲mac app。。bug有點多 放棄了 看介紹仍是不錯的 不過git也夠我用了 就醬

完結