最近打算學習一下go語言,瞭解之後打算通過go語言聖經學習,繼而瞭解到了GitBook,爲了加深學習打算在自己的服務器上發佈該書籍服務。
GitBook是一個命令行工具(和Node.js庫),用於使用GitHub / Git和Markdown(或AsciiDoc)構建漂亮的書。這是一個示例:學習Javascript。官方github:https://github.com/GitbookIO/gitbook
部署機器爲阿里雲主機,系統爲Ubuntu 16.04.6,接下來就開始了GitBook發佈之路:
1.安裝node.js和npm
apt install nodejs-legacy
apt install npm
安裝之後可以通過node -v 和npm -v查看版本檢驗是否成功
2.安裝gitBook
npm config set registry https://registry.npm.taobao.org 設置淘寶鏡像源
npm install -g gitbook-cli
gitbook -V
3.下載Go語言聖經源碼
git clone https://github.com/gopl-zh/gopl-zh.github.com.git
4.安裝gitbook插件
cd gopl-zh.github.com/
gitbook install
5.發佈服務
nohup gitbook serve &
Q&A
1.安裝gitbook後執行install時報錯TypeError: Cannot read property 'commands' of null?
該問題是版本不配導致的,網絡上都說要降低gitbook版本,我嘗試了未解決,後在stackoverflow找到需要升級本身node和npm版本,升級後順利解決該問題。
linux中更新npm和node版本:
1.安裝node版本管理工具
npm install -g n
2.更新最新的node穩定版本
n stable
3.更新npm版本
npm install -g npm
2.gitbook命令?
gitbook build -------編譯項目文件,生成_book/文件,內部爲生成的html文件
gitbook serve -------啓動 書籍服務,可以通過--port指定端口,默認爲4000
gitbook install -------安裝所需插件依賴
gitbook init -------初始化新書籍項目,生成README.md和SUMMARY.md文件
其他命令諸如轉化爲pdf,epub,mobi文件可以參考https://blog.csdn.net/axi295309066/article/details/61420694
天下只有三分月