搭建Gitbook+Gitee电子书管理工具(一)
目錄
- 搭建Gitbook+Gitee電子書管理工具
- 1.安裝使用gitbook
- 2.搭建Gitee倉庫進行版本管理
搭建Gitbook+Gitee電子書管理工具
Gitbook 是一個基于node.js命令的電子書制作工具。其支持Markdown等語法格式進行編輯,可生成HTML與PDF等格式的電子書。關于Gitbook的具體介紹可以參考博文:Gitbook 從懵逼到入門。常搭配版本管理平臺為Github (網上已有許多相關教程)。由于Github有時不穩定,本文采用Gitbook + Gitee的搭配。
1.安裝使用gitbook
具體步驟如下:
安裝Node.js
可通過 node -v檢查是否安裝Node.js以及其版本,若未安裝則選擇一個版本進行安裝。本文采用10.14.2版本,下載地址為:https://nodejs.org/download/release/
Ps. 1)Node.js版本不匹配會導致后續出現報錯
2)如需Node.js 多版本控制則需要用到nvm,本文不做擴充。
安裝Gitbook
采用命令 npm install gitbook-cli -g進行全局安裝
采用命令gitbook -V查看安裝情況
編輯器推薦
個人推薦Typroa
實例展示
Gitbook init 初始化
會生成文件README.md與SUMMARY.md。
可以通過編輯文件SUMMARY.md來確立電子書主體結構。
示例代碼:
可在通過命令Gitbook init自動生成對應文件夾、文件。
執行Gitbook serve后通過訪問http://localhost:4000瀏覽電子書。示例效果如下圖。
2.搭建Gitee倉庫進行版本管理
Gitbook + Gitee的配置類似于Gitbook + Github(網上有很多教程)。
本文以下只做幾點注釋:
并不是必須設置,但是建議設置。git基于多種傳輸協議,如https和ssh,來保障數據傳輸安全。如果不設置ssh公鑰每次提交代碼都要輸入你的帳號密碼。設置ssh密鑰的目的是為了省略輸入用戶名密碼的過程。
生成/添加SSH公鑰的方法見:官方文檔。
Git相關基本操作可見網址Git基本操作。
總結
以上是生活随笔為你收集整理的搭建Gitbook+Gitee电子书管理工具(一)的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: SPWM波调制度原理
- 下一篇: VS终结者原理及思路简要说明