GitBook本地+線上創作
常用的筆記軟件一般是 OneNote, 但 OneNote 不支持 MarkDown 格式, 於是寫什么記錄只能開 Typora 來寫就很頭疼, 畢竟以目錄來組織各種文件常常是, 一個目錄下太多文件, 然后要回看時也面臨查找不方便等各種原因, 寫完之后如果不是發布博文, 那么很可能就是堆在一旁----垃圾山是也.
因此很久之前, 學長推薦了寫 Wiki 的方式, 然后參照學長的 Wiki, 覺得可以利用 gitbook 等工具, 去把松散的, 各自為營的筆記們給組織起來, 然后之前嘗試過線上編輯 gitbook, 但基本是疏於維護.
現在自然是要撿起來, 關於gitbook的使用百度有很多, 但是本地+線上創作的模式, emm還是找了十分鍾才找到於是記錄一下子(水博客).
gitbook下載
-
本地需要安裝node.js, 一般來說居家常備
具體安裝請百度
-
因為是本地+線上創作, 因此, 需要同步原本在 gitbook web端的東西, 同步是通過GitHub倉庫來同步的, 所以還需要安裝Git Bash.
然后GitBook賬號與Github賬號相信也是准備好了的. 相信Git Bash也綁定好了Github賬號少了以上任意一處加粗的都不行.
-
現在你的本地已經安裝了node.js , 運行命令進行安裝
npm install gitbook -g
上面這條是百度如何安裝能找到的最多的命令, 但是我這里運行完后提示:
You need to install "gitbook-cli" to have access to the gitbook command anywhere on your system.
If you've installed this package globally, you need to uninstall it.Run "npm uninstall -g gitbook" then "npm install -g gitbook-cli"
於是就接着運行
npm install -g gitbook-cli
然后再輸入
git --version
命令查詢是否已完成安裝到目前為止, gitbook的本地創作模式已經配置好了.
GitBook后台同步
-
同步gitbook 官網, 我們是通過集成GitHub來完成同步的, 因此, 進入儀表盤, 開啟GitHub集成,
彈出什么授權就授權一下子就好了, 然后去GitHub創建一個新的倉庫, 在彈出的頁面按照提示勾選一下
去到剛剛新建的倉庫, 發現已經多了這么多東西,
-
然后復制倉庫的下載路徑(點上圖Code綠色按鈕), 打開Git Bash, 執行
git clone *
,*
這里替換成下載路徑. -
然后試試在cmd里運行
gitbook serve
,然后輸入對應的網址, 原先在GitBook上寫的就已經順利在本地運行了, (再也不用去GitBook后台調格式調半天了)效果圖:
-
接下來,就是熟練運用git命令自如完成線上/本地兩種創作~~,同時GitBook后台的儀表盤還是支持蠻多自定義的,如圖標, 自定義域名, 一鍵開啟Google Analysis等等, 可以說其美觀的頁面極大地拯救了俺這樣的手殘.