Gitbook詳解（一）-介紹和安裝詳解

目錄

• 1. 簡介
• 2. 環境准備
  • 2.1 下載和安裝 Node.js
  • 2.2 安裝 ebook-concert 依賴
• 3. 安裝 gitbook-cli
• 4. 相關概述
• 5. 相關網站參考

1. 簡介

Gitbook 是什么？其實用一句話就可以概括，它是一個能將使用 Markown 語法的 md 格式文檔，快速制作成各種格式電子書的工具。。

常被用於編寫文檔或者電子書，特點是方便簡潔，易於使用。只要熟悉輕量級標記語法的 Markdown 語法，就能使用Gitbook來制作各種格式的電子書。接下來筆者就來分享一下自己使用 Gitbook 的方法和經驗，會分類來介紹，感興趣的可以關注筆者關於 Gitbook 這個系列的文章。

系列文章快捷導航：

1. Gitbook詳解（一）-介紹和安裝詳解
2. Gitbook詳解（二）-命令行的使用
3. Gitbook詳解（三）-目錄結構詳解
4. Gitbook詳解（四）-配置和說明詳解
5. Gitbook詳解（五）-插件的配置和使用詳解
6. Gitbook詳解（六）-導出電子書詳解
7. Gitbook詳解（七）-Markdown編輯器推薦
8. Gitbook詳解（八）-發布書籍

本系列在線書籍導航：

1. 在線訪問教程網站1： https://jiangminggithub.github.io/gitbook/

2. 在線訪問教程網站2： https://jiangming_gitee.gitee.io/gitbook/

2. 環境准備

2.1 下載和安裝 Node.js

• 官網：https://nodejs.org/
• 官網（中文）：https://nodejs.org/zh-cn
• 中文鏡像網站：http://nodejs.cn
• 淘寶的鏡像下載：https://npm.taobao.org/mirrors/node

進入上面網站進入選擇相關平台下載對應的版本的 Node.js 方法或者安裝包，一種是官網根據不同的平台對應的命令來安裝，還有一種是下載二進制安裝包（筆者推薦方法），進行環境變量配置，本文將介紹筆者的環境安裝 Node.js，筆者使用的是Linux Ubuntu環境，使用二進制安裝包來安裝。

注意: 基於截止到目前的 Gitbook V3.2.3版本，需要使用NodeJs的v10+版本，否則會產生各種報錯。
推薦使用：node-v10.24.0-linux-x64

下載 node-v10.24.0-linux-x64 版本的壓縮包后，解壓到特定的目錄，進行環境變量配置。

執行 vim ~/.profile 或者 vim ~/.bashrc 后添加下面的環境變量配置

$ vim ~/.profile
export DART_HOME=TargetPath/node-v10.24.0-linux-x64
export PATH=${DART_HOME}/bin:$PATH

安裝完成之后，可以通過下面的命令來驗證一下 Node.js 是否安裝成功。

$ node -v                                                
v10.24.0

2.2 安裝 ebook-concert 依賴

ebook-concert 主要用於生成 PDF、eBook，Mobi 等格式的電子書，具體各平台的下載安裝參考官網：https://calibre-ebook.com/download

這里我是使用的Ubuntu平台，執行下面的命令即可：

sudo -v && wget -nv -O- https://download.calibre-ebook.com/linux-installer.sh | sudo sh /dev/stdin

安裝完成之后，可以通過下面的命令來驗證一下 ebook-concert 是否安裝成功。

$ ebook-convert --version
ebook-convert (calibre 5.13.0)
Created by: Kovid Goyal <[e-mail]>

3. 安裝 gitbook-cli

執行安裝命令, 參考：https://www.npmjs.com/package/gitbook

$ npm config set registry http://registry.npm.taobao.org   // 可選，設置一下淘寶鏡像
$ npm install gitbook-cli -g

安裝完成之后，可以通過下面的命令來驗證一下 Gitbook 是否安裝成功。

$ gitbook -V
CLI version: 2.3.2
GitBook version: 3.2.3

4. 相關概述

1. 看完上面的介紹，是不是知道了 Gitbook 是什么，主要用於做什么了？其實就是將我們的書寫的文章生成對應格式的電子書，方便分享大家瀏覽，比如生成pdf給其他人查看相關的內容，或者生成靜態 HTML，發布到網站服務器，可以通過在線電子書的方式分享給更多的人。當然您現在瀏覽的本書就是使用 Gitbook 進行制作和發布的。

2. 總之，Gitbook 就是一個電子書生成工具，類似與 Git ，Git 是一個代碼倉庫管理工具，用於管理代碼文件，並且可以生成代碼的變更記錄，同時具備上傳這些文件和變更記錄到指定的服務器。那么同理，我們也可以結合 Gitbook 和 Git 來管理我們的文檔和生成的電子書文件。當然，本書主要介紹 Gitbook，關於Git 的相關知識，可以參考其他相關的教程。

3. 和與Git 工具對應的 Github 倉庫一樣，Gitbook 也有一個官方的倉庫（可以在線編輯制作），可以上傳我們的電子書的文件，不過在國內貌似部分用戶訪問不了，但是也沒有關系，因為大多數情況主要還是利用這個工具生成的對應的格式電子書進行分享或者發布。

5. 相關網站參考

1. Gitbook 項目官網：https://www.gitbook.com
2. Gitbook 項目GitHub：https://github.com/GitbookIO/gitbook
3. Npm Toolchain：https://www.npmjs.com/
4. ebook-concert：https://calibre-ebook.com

好了，到此就完成了 Ubuntu 平台的 Gitbook 的安裝了，后續的文章會詳細介紹關於 Gitbook 的相關使用教程，以及部署自己的在線電子書，敬請關注！