Ubuntu 16.04.6運行GitBook書籍(Go語言聖經)

最近打算學習一下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

 

天下只有三分月

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章