1. 程式人生 > >gitbook簡單安裝和使用

gitbook簡單安裝和使用

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簡單安裝和使用