MacOS使用GitBook制作電子書

目錄

• 目錄
• 一、簡介
• 二、安裝
  • 1. 安裝node.js
  • 2. 安裝gitbook
• 三、使用
• 四、常用命令
  • 1. 初始化 或 編輯目錄
  • 2. 編輯內容之后編譯書籍
  • 3. 啟動web服務通過瀏覽器預覽數據
  • 4. 生成電子書

一、簡介

制作電子書的工具有很多，常用的免費工具推薦：

1. Sigil Ebook Editor
   • 應是最早的電子書制作軟件（大概在10年左右就有了）
   • 可視化編輯內容、插入封面、編輯作者、生成目錄
2. ePUBee Maker(ePUBee智多星)
   • 一款Microsoft Word的插件，將Word文檔無損的存為電子書
   • 可導入電子書進行編輯，完美的編輯內容與元數據信息
3. GitBook
   • 同GitHub一樣，將電子書作為一個工程，方便的控制版本
   • 提供GitBook Editor直接集成GitBook、Git、Markdown等功能

我選擇的是GitBook，因為我是程序員，對git有不一樣的信賴。

此文主要對在MacOS上使用GitBook做入門級說明。

二、安裝

其實可以直接使用homebrew來安裝，這里不做具體說明，命令如下：

brew cask install gitbook gitbook-editor

我采取的的方式是安裝 gitbook-cli，具體方式如下：

1. 安裝node.js

因為gitbook基於node.js，所以需要先安裝node

# 可以先 brew search node 查看版本，然后安裝你想要的版本
brew install node

查看版本，即安裝是否成功

node -v
npm -v



2. 安裝gitbook

# 注意 -g 參數
npm install -g gitbook-cli

安裝之后會多出一個 gitbook 的命令，直接操作就可以了

三、使用

1. 新建文件夾test，作為一本書，並完成初始化

   mkdir test
   cd test
   
   # 初始化
   
   gitbook init
   

   第一次執行時間會比較長，看到如下內容即為成功
   

2. 執行后在test目錄中會生成如下兩個文件

   • README.md：書籍的介紹寫在這個文件里
   • SUMMARY.md：書籍的目錄結構在這里配置

   

3. 編輯這兩個文件輸入任意內容，目錄格式舉例
   

   注明：我這里使用的是 Typora 做為markdown編輯器

4. 編輯內容之后，回到終端，再次執行 gitbook init ，生成目錄，如圖：
   

   然后我們就可以編輯自己的電子書了

四、常用命令

1. 初始化 或 編輯目錄

gitbook init

2. 編輯內容之后編譯書籍

可以指定目錄，默認當前

gitbook build [書籍路徑] [輸出路徑]

3. 啟動web服務通過瀏覽器預覽數據

默認端口4000

gitbook serve --port 1234 

4. 生成電子書

# 生成 PDF 格式的電子書
gitbook pdf ./ ./book_name.pdf

# 生成 epub 格式的電子書
gitbook epub ./ ./book_name.epub

# 生成 mobi 格式的電子書
gitbook mobi ./ ./book_name.mobi

初次生成電子書的時候，可能會出現如下錯誤：


解決方式：根據提示通過安裝calibre-ebook來安裝ebook-convert

1. 下載地址：https://calibre-ebook.com/dist/osx

2. 安裝之后，建立軟鏈

   ln -s /Applications/calibre.app/Contents/MacOS/ebook-convert /usr/local/bin/ebook-convert