gitbook簡單安裝和使用
阿新 • • 發佈:2018-06-30
AR 初始化 創建目錄 png 上層 cnpm npm cnp 模式
1、gitbook是用來寫書的,支持markdown等
2、在線寫
gitbook最新版地址:https://www.gitbook.com/account/ 免費用戶只能有一個public和一個private項目
gitbook的老版地址:https://legacy.gitbook.com/
可以使用上面的兩個網頁,直接在線寫書,但是網絡,你得給力
如圖所示,點擊Read可以進入在線閱讀模式;
點擊Open in Desktop可以打開電腦的客戶端(如果沒有的話,會進入下載頁面),客戶端和在線編輯功能一樣,這樣,你就可以先線下編輯,然後定期同步一次就可以了。這樣不用太依賴網絡了
下面的是gitbook的git clone地址,你可以git clone下來編輯
mac客戶端:這樣使用其實也方便的
3、離線寫:
下載gitbook工具:
- 安裝npm、cnpm;
- 安裝cnpm/
npm install gitbook-cli -g
- 創建目錄並初始化:SUMMARY是整個項目的目錄,或者書的目錄,參考下圖
- 編輯完啟動:在test目錄直接gitbook serve或者在test上層目錄gitbook serve test
打開離線頁面:
這樣離線完全編輯完或者中間隨時,把你的本地內容上傳到github或者gitbook上去進行發布即可
遺留問題:gitbook沒有github那樣的ssh公鑰方式免密git clone,因此每次都要輸入帳號和密碼,但是我又沒有註冊gitbook的帳號,使用github直接登錄的,所以沒辦法使用git clone之類的操作,好糾結
參考:
https://yuzeshan.gitbooks.io/gitbook-studying/content/index.html
參考源碼:https://github.com/yuzeshan/gitbook-studying
gitbook簡單安裝和使用