gitbook 入門教程之匯出電子書

gitbook 既可以將原始碼檔案單獨輸出,也可以僅輸出單個檔案,常見的匯出電子書格式主要有三種(ePub, Mobi, PDF),而這三種格式都依賴於系統本身提供的 ebook-convert 工具.

安裝依賴

如果直接執行 gitbook pdf 相關命令,可能會報錯,提示需要安裝 ebook-convert 外掛,根據提示本地需要安裝 calibre 軟體,這樣 gitbook 才能正常匯出電子書.

calibre 官網: calibre-ebook.com/

linux 系統

下載地址: calibre-ebook.com/download_li…

• 下載應用

$ sudo -v && wget -nv -O- https://download.calibre-ebook.com/linux-installer.sh | sudo sh /dev/stdin
複製程式碼

• 配置軟連結

$ sudo ln -s /usr/bin/nodejs /usr/bin/node
複製程式碼

mac 系統

下載地址: calibre-ebook.com/download_os…

• 下載應用

將 calibre.app 移動到應用程式檔案,然後嘗試是否能正常開啟應用.

• 配置軟連結

$ sudo ln -s ~/Applications/calibre.app/Contents/MacOS/ebook-convert /usr/bin
複製程式碼

• 測試命令

$ ebook-convert --version
複製程式碼

如果沒有輸出 ebook-convert 版本資訊,可能需要配置環境變數.

配置封面

所有格式的電子書都可以配置自定義封面,在專案的根目錄下提供 cover.jpg 和 cover_small.jpg 兩種封面圖片時,生成電子書會自動增加封面頁.

當然你也可以使用 autocover 外掛 自動生成封面,不過本人才疏學淺,幾經嘗試始終沒有成功,如果有人成功了記得給我留言下哈!

封面的基本要求:

• cover.jpg 尺寸大小: 1800X2360 px,cover_small.jpg 尺寸大小: 200x262 px;
• 無邊界
• 清晰可見的書名
• 任何重要的文字在小版本封面圖片中也要清晰可見

更多封面相關規範請參考 toolchain.gitbook.com/ebook.html

基本命令

語法格式: gitbook pdf 或 gitbook epub 或 gitbook mobi

示例:

# 生成 `pdf` 檔案並輸出 `debug` 級別日誌
$ gitbook pdf ./ ./myBook.pdf --log=debug

# 生成 `epub` 檔案並輸出 `debug` 級別日誌
$ gitbook epub ./ ./myBook.epub --log=debug

# 生成 `mobi` 檔案並輸出 `debug` 級別日誌
$ gitbook mobi ./ ./myBook.mobi --log=debug
複製程式碼

相信大家對 PDF 格式比較熟悉,其餘兩種格式只是不同電子書格式,因而需要相應軟體支援.

生成 PDF 檔案

示例:

$ gitbook pdf
複製程式碼

預設在當前專案的根目錄下生成 book.pdf 檔名,如果配有封面,則首頁顯示封面,否則無封面.

生成 ePub 檔案

示例:

$ gitbook epub
複製程式碼

預設在當前專案的根目錄下生成 book.epub 檔名,如果配有封面,則首頁顯示封面,否則無封面.

生成 mobi 檔案

示例:

$ gitbook mobi
複製程式碼

預設在當前專案的根目錄下生成 book.mobi 檔名,如果配有封面,則首頁顯示封面,否則無封面.

小結

本節主要介紹瞭如何匯出電子書,概括來說,首先系統需要安裝 ebook-convert 工具,然後配置電子書封面,最後直接匯出為目標格式(ePub, Mobi, PDF)進行輸出.

隨著電子書內容越來越多,生成電子書所花費的時間也越來越久,實屬正常,耐心等待即可.

輸出 PDF 檔案並輸出 debug 日誌: gitbook pdf --log=debug