1. 簡(jiǎn)介
Gitbook 是什么？其實(shí)用一句話(huà)就可以概括，它是一個(gè)能將使用 Markown 語(yǔ)法的 md 格式文檔佳魔，快速制作成各種格式電子書(shū)的工具。晦炊。
常被用于編寫(xiě)文檔或者電子書(shū)鞠鲜，特點(diǎn)是方便簡(jiǎn)潔，易于使用断国。只要熟悉輕量級(jí)標(biāo)記語(yǔ)法的 Markdown 語(yǔ)法贤姆，就能使用Gitbook來(lái)制作各種格式的電子書(shū)。接下來(lái)筆者就來(lái)分享一下自己使用 Gitbook 的方法和經(jīng)驗(yàn)稳衬，會(huì)分類(lèi)來(lái)介紹霞捡，感興趣的可以關(guān)注筆者關(guān)于 Gitbook 這個(gè)系列的文章。
本系列在線書(shū)籍導(dǎo)航：
在線訪問(wèn)教程網(wǎng)站1： https://jiangminggithub.github.io/gitbook/
在線訪問(wèn)教程網(wǎng)站2： https://jiangming_gitee.gitee.io/gitbook/
2. 環(huán)境準(zhǔn)備
2.1 下載和安裝 Node.js
- 官網(wǎng)：https://nodejs.org/
- 官網(wǎng)（中文）：https://nodejs.org/zh-cn
- 中文鏡像網(wǎng)站：http://nodejs.cn
- 淘寶的鏡像下載：https://npm.taobao.org/mirrors/node
進(jìn)入上面網(wǎng)站進(jìn)入選擇相關(guān)平臺(tái)下載對(duì)應(yīng)的版本的 Node.js 方法或者安裝包宋彼，一種是官網(wǎng)根據(jù)不同的平臺(tái)對(duì)應(yīng)的命令來(lái)安裝弄砍，還有一種是下載二進(jìn)制安裝包（筆者推薦方法）仙畦，進(jìn)行環(huán)境變量配置，本文將介紹筆者的環(huán)境安裝 Node.js音婶，筆者使用的是Linux Ubuntu環(huán)境慨畸，使用二進(jìn)制安裝包來(lái)安裝。
注意: 基于截止到目前的 Gitbook V3.2.3版本衣式，需要使用NodeJs的v10+版本寸士，否則會(huì)產(chǎn)生各種報(bào)錯(cuò)。
推薦使用：node-v10.24.0-linux-x64
下載 node-v10.24.0-linux-x64 版本的壓縮包后碴卧，解壓到特定的目錄弱卡，進(jìn)行環(huán)境變量配置。
執(zhí)行 vim ~/.profile 或者 vim ~/.bashrc 后添加下面的環(huán)境變量配置
$ vim ~/.profile
export DART_HOME=TargetPath/node-v10.24.0-linux-x64
export PATH=${DART_HOME}/bin:$PATH
安裝完成之后住册，可以通過(guò)下面的命令來(lái)驗(yàn)證一下 Node.js 是否安裝成功婶博。
$ node -v
v10.24.0
2.2 安裝 ebook-concert 依賴(lài)
ebook-concert 主要用于生成 PDF、eBook荧飞，Mobi 等格式的電子書(shū)凡人，具體各平臺(tái)的下載安裝參考官網(wǎng)：https://calibre-ebook.com/download
這里我是使用的Ubuntu平臺(tái)，執(zhí)行下面的命令即可：
sudo -v && wget -nv -O- https://download.calibre-ebook.com/linux-installer.sh | sudo sh /dev/stdin
安裝完成之后叹阔，可以通過(guò)下面的命令來(lái)驗(yàn)證一下 ebook-concert 是否安裝成功挠轴。
$ ebook-convert --version
ebook-convert (calibre 5.13.0)
Created by: Kovid Goyal <kovid@kovidgoyal.net>
3. 安裝 gitbook-cli
執(zhí)行安裝命令, 參考：https://www.npmjs.com/package/gitbook
$ npm config set registry http://registry.npm.taobao.org // 可選，設(shè)置一下淘寶鏡像
$ npm install gitbook-cli -g
安裝完成之后耳幢，可以通過(guò)下面的命令來(lái)驗(yàn)證一下 Gitbook 是否安裝成功岸晦。
$ gitbook -V
CLI version: 2.3.2
GitBook version: 3.2.3
4. 相關(guān)概述
- 看完上面的介紹，是不是知道了 Gitbook 是什么睛藻，主要用于做什么了启上？其實(shí)就是將我們的書(shū)寫(xiě)的文章生成對(duì)應(yīng)格式的電子書(shū)，方便分享大家瀏覽修档，比如生成pdf給其他人查看相關(guān)的內(nèi)容碧绞，或者生成靜態(tài) HTML，發(fā)布到網(wǎng)站服務(wù)器吱窝，可以通過(guò)在線電子書(shū)的方式分享給更多的人讥邻。當(dāng)然您現(xiàn)在瀏覽的本書(shū)就是使用 Gitbook 進(jìn)行制作和發(fā)布的。
- 總之院峡，Gitbook 就是一個(gè)電子書(shū)生成工具兴使，類(lèi)似與 Git ，
Git是一個(gè)代碼倉(cāng)庫(kù)管理工具照激，用于管理代碼文件发魄，并且可以生成代碼的變更記錄，同時(shí)具備上傳這些文件和變更記錄到指定的服務(wù)器。那么同理励幼，我們也可以結(jié)合 Gitbook 和 Git 來(lái)管理我們的文檔和生成的電子書(shū)文件汰寓。當(dāng)然，本書(shū)主要介紹 Gitbook苹粟，關(guān)于Git 的相關(guān)知識(shí)有滑，可以參考其他相關(guān)的教程。
- 和與Git 工具對(duì)應(yīng)的 Github 倉(cāng)庫(kù)一樣嵌削，Gitbook 也有一個(gè)官方的倉(cāng)庫(kù)（可以在線編輯制作）毛好，可以上傳我們的電子書(shū)的文件，不過(guò)在國(guó)內(nèi)貌似部分用戶(hù)訪問(wèn)不了苛秕，但是也沒(méi)有關(guān)系肌访，因?yàn)榇蠖鄶?shù)情況主要還是利用這個(gè)工具生成的對(duì)應(yīng)的格式電子書(shū)進(jìn)行分享或者發(fā)布。
5. 相關(guān)網(wǎng)站參考
- Gitbook 項(xiàng)目官網(wǎng)：https://www.gitbook.com
- Gitbook 項(xiàng)目GitHub：https://github.com/GitbookIO/gitbook
- Npm Toolchain：https://www.npmjs.com/
- ebook-concert：https://calibre-ebook.com
好了艇劫，到此就完成了 Ubuntu 平臺(tái)的 Gitbook 的安裝了吼驶，后續(xù)的文章會(huì)詳細(xì)介紹關(guān)于 Gitbook 的相關(guān)使用教程，以及部署自己的在線電子書(shū)港准，敬請(qǐng)關(guān)注旨剥！
