1. 安裝Nodejs
由於gitbook依賴於nodejs來實現的,所以需要首先安裝nodejs,才能使用gitbook
關於Nodejs的安裝參見:https://www.runoob.com/nodejs/nodejs-install-setup.html
2. 安裝gitbook
npm install gitbook -g
npm install gitbook-cli -g
執行如下命令,正常返回版本信息即表示安裝成功:
# gitbook -V
CLI version: 2.3.2
GitBook version: 3.2.3
3. 安裝 calibre
calibre
是一個功能強大的電子書管理軟件,下載地址:https://calibre-ebook.com/download,選擇對應的系統並安裝即可
4. gitbook轉PDF、epub
進入到gitbook項目目錄下,執行如下命令生成PDF:
gitbook pdf .
執行如下命令將生成epub:
gitbook epub .
5. 存在問題
可能部分同學在執行轉換命令時,會包如下錯誤:
InstallRequiredError: "ebook-convert" is not installed.
Install it from Calibre: https://calibre-ebook.com
此原因是由於calibre
未安裝或安裝目錄未加入環境變量,我的是Mac系統,calibre
的安裝目錄爲:/Applications/calibre.app/
,其相關轉換程序存儲在 /Applications/calibre.app/Contents/MacOS/
目錄下,只需要將此路徑加入環境變量即可,這裏我們只需要用到ebook-convert
這一個程序,只需要爲ebook-convert
創建軟鏈即可:
ln -s /Applications/calibre.app/Contents/MacOS/ebook-convert /usr/local/bin
其他操作系統在安裝目錄下尋找到ebook-convert
,將其所在路徑加入環境變量即可使用