GitBook是一款基于Node.js開發的開源的工具，可以通過命令行的方式創建電子書項目，再使用 MarkDown 編寫電子書內容，然后生成 PDF、ePub、mobi 格式的電子書，或生成一個靜態站點。

除此之外，還可以利用Git命令管理電子書版本。如果你是 GitHub 的重度使用者，還可以把你的 GitBook 帳戶和 GitHub 帳戶關聯起來，這樣不論在任何一方修改了內容，都可以互相同步。

一、安裝 Node.js

由于 GitBook 是基于 Node.js 開發的，所以依賴 Node.js 環境。如果您的系統中還未安裝 Node.js，請點擊下面的鏈接，根據你所使用的系統下載對應的版本。如果已安裝則略過本步驟。

Node.js 下載頁面：https://nodejs.org/en/download/stable/

Windows 版和 Mac 版的 Node.js 都是常規的安裝包，連續下一步安裝即可。Lunix 版可以參照官方文檔通過 yum、apt-get 之類的工具安裝，也可以通過源碼包安裝，如下所示：

$ wget https://nodejs.org/dist/v5.4.1/node-v5.4.1.tar.gz
$ tar zxvf node-v5.4.1.tar.gz
$ cd node-v5.4.1
$ ./configure
$ make
$ make install

二、安裝 GitBook

打開“命令提示符”（Mac 系統打開“終端”）輸入以下命令安裝 GitBook：

$ npm install gitbook-cli -g

由于網絡的原因，安裝的時間可能會較長一些，請耐心等待直到安裝完成。安裝完成后可以輸入以下命令，以查看 GitBook 版本的方式檢查是否安裝成功：

$ gitbook -V

三、創建電子書項目

新建一個目錄，并進入該目錄使用 gitbook 命令初始化電子書項目。舉個例子，現在要創建一個名為“MyFirstBook”的空白電子書項目，如下所示：

$ mkdir MyFirstBook
$ cd MyFirstBook
$ gitbook init

四、編輯電子書內容

初始化后的目錄中會出現“README.md（電子書簡介文件）”和“SUMMARY.md（導航目錄文件）”兩個基本文件。除此之外還可以手動新建其它“Glossary.md（書尾的詞匯表）”、“book.json（電子書配置文件）”。電子書的正文內容可以根據自己的喜好創建新的后綴為 .md 文件，如“chapter01.md”，然后用 MarkDown 編寫具體的文本內容即可。下面對這些文件分別做詳細介紹。

1、README.md

此文件是簡單的電子書介紹，可以把您所制作的電子書做一下簡單的描述：

# 簡介

這是我的第一本使用 GitBook 制作的電子書。

2、SUMMARY.md

此為電子書的導航目錄文件，每當新增一個章節文件就需要向此文件中添加一條記錄。對于 Kindle 電子書來說，此文件所呈現的目錄結構就是開頭的目錄內容和“前往”的目錄導航。

# Summary

* [簡介](README.md)
* [第一章](section1/README.md)
* [第二章](section2/README.md)

如果需要“子章節”可以使用Tab縮進來實現（最多支持三級標題），如下所示：

# Summary

* [第一章](section1/README.md)
    * [第一節](section1/example1.md)
    * [第二節](section1/example2.md)
* [第二章](section2/README.md)
    * [第一節](section2/example1.md)

3、Glossary.md

對于電子書內容中需要解釋的詞匯可在此文件中定義。詞匯表會被放在電子書末尾。其格式如下所示：

# 電子書
電子書是指將文字、圖片、聲音、影像等訊息內容數字化的出版物和植入或下載數字化文字、圖片、聲音、影像等訊息內容的集存儲和顯示終端于一體的手持閱讀器。

# Kindle
Amazon Kindle 是由 Amazon 設計和銷售的電子書閱讀器（以及軟件平臺）。用戶可以通過無線網絡使用 Amazon Kindle 購買、下載和閱讀電子書、報紙、雜志、博客及其他電子媒體。

4、book.json

“book.json”是電子書的配置文件，可以看作是電子書的“原數據”，比如 title、description、isbn、language、direction、styles 等，更多點擊這里查看。它的基本結構如下所示：

{
    "title": "我的第一本電子書",
    "description": "用 GitBook 制作的第一本電子書！",
    "isbn": "978-3-16-148410-0",
    "language": "zh-tw",
    "direction": "ltr"
}

5、普通章節.md 文件

普通章節.md 文件可以使用您感覺順手的文本編輯器編寫。MarkDown 的寫法可以點擊這里查看相關示例。每編寫一個 .md 文件，不要忘了在“SUMMARY.md”文件中添加一條記錄哦。

6、電子書封面圖片

GitBook 幫助文檔建議封面圖片的尺寸為 1800*2360 像素并且遵循建議：

沒有邊框
清晰可見的書本標題
任何重要的文字在小版本中應該可見

圖片的格式為 jpg 格式。把圖片重命名為“cover.jpg”放到電子書項目文件夾即可。

五、預覽電子書內容

電子書內容編寫完畢后可以使用瀏覽器預覽一下。先輸入下面的命令據 .md 文件生成 HTML 文檔：

$ gitbook build

生成完畢后，會在電子書項目目錄中出現一個名為“_book”的文件夾。進入該文件夾，直接用瀏覽器打開“index.html”，或先輸入下面的命令：

$ gitbook serve

然后在瀏覽器中輸入“http://localhost:4000”即可預覽電子書內容，預覽完畢后按Ctrl + C結束。

六、生成電子書文件

確定電子書沒有問題后，可以通過輸入以下命令生成 mobi 電子書：

$ gitbook mobi ./ ./MyFirstBook.mobi

如果出現以下錯誤提示，說明您還未安裝 Calibre。由于 GitBook 生成 mobi 格式電子書依賴 Calibre 的 ebook-convert，所以請先點擊這里下載安裝 Calibre。

Error: Need to install ebook-convert from Calibre

Calibre 安裝完畢后，對于 Mac OS X 系統，還需要先設置一下軟鏈接：

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

再次運行轉換命令，即可生成 mobi 格式電子書。

七、把項目托管到 GitBook.com

以上所有的步驟都是在本地進行的，如果需要實現電子書的版本管理，或者把電子書發布到網絡上，還可以通過 Git 命令將本地的項目托管到 GitBook.com 上。

1、注冊 GitHub.com 賬號

首先進入GitBook.com注冊一個賬號，并新建一個項目。在“Setting（設置）”頁面獲取到“Git URL（Git 鏈接）”，鏈接的樣子如下所示：

https://git.gitbook.com/kindlefere/myfirstbook.git

2、安裝 Git 軟件

在開始下面的步驟之前請先確保您的系統中已經安裝了 Git。一般 Mac 和 Lunix 自帶 Git 功能，可以在終端運行git --version查看 Git 版本。Windows 一般不會自帶 Git 功能，請點擊這里下載先安裝。

在安裝 Windows 版的 Git 時，會看到“Use Git from Git Bash only”和“Use Git from the Windows Command prompt”兩個選項。前者指的在程序自帶的獨立終端中使用 Git。后者是指可以通過系統自帶的“命令提示符”使用 Git 命令。可以根據自己的喜好選擇，個人推薦使用后者。

3、上傳已有的電子書項目

在本地新建一個文件夾，并通過 Git 命令把剛才新建的遠程項目抓取到本地，如下所示：

$ mkdir MyFirstBook-Git
$ cd MyFirstBook-Git
$ git init
$ git pull https://git.gitbook.com/kindlefere/myfirstbook.git

然后把本地項目“MyFirstBook”中的所有內容拷貝到剛才新建的文件夾中，如上面的“MyFirstBook-Git”。然后使用 Git 命令把本地的項目上傳到遠程，如下所示：

$ git add -A
$ git commit -m "提交說明"
$ git remote add gitbook https://git.gitbook.com/kindlefere/myfirstbook.git
$ git push -u gitbook master

期間需要輸入你的 GitBook 注冊郵箱和密碼。今后修改內容后只需要輸入以下 Git 命令即可：

$ git add [修改的文件]
$ git commit -m "提交說明"
$ git push -u gitbook master

八、把項目關聯到 GitHub 帳戶

如果你喜歡使用 GitHub 管理項目。還可以把您的 GitBook 帳戶和 GitHub 帳戶關聯起來，這樣兩者的修改內容就可以互相同步了。

1、關聯 GitBook 和 GitHub 帳戶

關聯設置也很簡單，首先進入 GitBook 的“Account Settings（帳戶設置）”頁面，在“Profile（個人資料）”標簽頁找到“GitHub”選項卡，點擊【Connect to GitHub】按鈕會轉向 GitHub 的“Authorize application”頁面，點擊【Authorize application】按鈕即可完成關聯。

2、把 GitBook 項目導入到 GitHub

完成關聯后即可設置同步電子書項目了。以電子書項目“MyFirstBook”為例，首先需要把項目導入到 GitHub 中一份。進入某個電子書項目的設置頁面，切換到“GitHub”選項卡。在“GitHub Repository”中，點擊【Export to GitHub】按鈕，按照向導所示步驟將項目導入 GitHub 中。

3、設置 GitBook 和 GitHuB 同步

導出成功后，再回到 GitBook 項目設置頁面的“GitHub”選項卡，在“GitHub Repository”中的輸入框中填入 GitHub 的 Repository 名，如“GitHub用戶名/myfirstbook”，點擊【Save】按鈕保存。

保存后當前頁面會出現一個名為“Integration”的選項卡，點擊里面的【Add webhook】按鈕，允許 GitBook 接收 Github 的內容更新。這樣就把 GitBook 上的項目和 GitHub 相對應的項目關聯上了。

此后即可用 GitHub 管理電子書項目，在 GitBook 上對電子書內容修改也會自動同步到 GitHub 中。

總結

以上是生活随笔為你收集整理的GitBook制作电子书详细教程（命令行版）的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。