是什么会喝？
在我認(rèn)識(shí) GitBook 之前陡叠，我已經(jīng)在使用 Git 了，毋容置疑好乐，Git 是目前世界上最先進(jìn)的分布式版本控制系統(tǒng)匾竿。
我認(rèn)為 Git 不僅是程序員管理代碼的工具，它的分布式協(xié)作方式同樣適用于很多場(chǎng)合蔚万，其中一個(gè)就是寫(xiě)作（這會(huì)是一個(gè)引起社會(huì)變革的偉大的工具Ａ胙）。所以在我發(fā)現(xiàn) GitBook 之前反璃，實(shí)際上我已經(jīng)無(wú)數(shù)次想象過(guò)它的使用場(chǎng)景了昵慌。
咋一看 GitBook 的名字，你可能會(huì)認(rèn)為它是關(guān)于 Git 的一本書(shū)淮蜈。而當(dāng)你有所了解之后斋攀，你也許會(huì)認(rèn)為它是一個(gè)使用 Git 構(gòu)建電子書(shū)的工具。其實(shí)不然梧田，GitBook 與 Git 的關(guān)系淳蔼，就像雷鋒塔和雷鋒那樣，沒(méi)有一點(diǎn)關(guān)系裁眯！
實(shí)際上鹉梨，GitBook 是一個(gè)基于 Node.js 的命令行工具，支持 Markdown 和 AsciiDoc 兩種語(yǔ)法格式穿稳，可以輸出 HTML存皂、PDF、eBook 等格式的電子書(shū)逢艘。所以我更喜歡把 GitBook 定義為文檔格式轉(zhuǎn)換工具旦袋。
所以，GitBook 不是 Markdown 編輯工具它改，也不是 Git 版本管理工具疤孕。市面上我們可以找到很多 Markdown 編輯器，比如 Typora央拖、MacDown祭阀、Bear截亦、MarkdownPad、MarkdownX柬讨、JetBrains’s IDE（需要安裝插件）、Atom袍啡、簡(jiǎn)書(shū)踩官、CSDN 以及 GitBook 自家的 GitBook Editor 等等。
但 GitBook 又與 Markdown 和 Git 息息相關(guān)境输，因?yàn)橹挥袑⑺鼈兘Y(jié)合起來(lái)使用蔗牡，才能將它們的威力發(fā)揮到極致！因此嗅剖，通常我們會(huì)選擇合適的 Markdown 編輯工具以獲得飛一般的寫(xiě)作體驗(yàn)辩越；使用 GitBook 管理文檔，預(yù)覽信粮、制作電子書(shū)黔攒；同時(shí)通過(guò) Git 管理書(shū)籍內(nèi)容的變更，并將其托管到云端（比如 GitHub强缘、GitLab督惰、碼云，或者是自己搭建的 Git 服務(wù)器）旅掂，實(shí)現(xiàn)多人協(xié)作赏胚。
實(shí)際上，GitBook Editor 對(duì)于新手來(lái)說(shuō)是個(gè)不錯(cuò)的選擇商虐，它集成了 GitBook觉阅、Git、Markdown 等功能秘车，還支持將書(shū)籍同步到 gitbook.com 網(wǎng)站典勇，使我們可以很方便地編輯和管理書(shū)籍。但是不幸的是鲫尊，GitBook Editor 的注冊(cè)和登錄需要翻墻痴柔，即便注冊(cè)成功了也可能登錄不上，似乎是因?yàn)榫W(wǎng)站最近在升級(jí)疫向。
因此咳蔚，我推薦，也是我目前使用的搭配是 GitBook + Typora + Git搔驼。
為什么谈火？
通常，我們最開(kāi)始學(xué)習(xí)和使用的辦公軟件就是 Word舌涨、Excel 和 PowerPoint糯耍。這里不是說(shuō)它們已經(jīng)過(guò)時(shí)了，不是說(shuō) GitBook 能夠替代它們。
相反温技，Microsoft 的辦公軟件很優(yōu)秀并且經(jīng)受了時(shí)間的考驗(yàn)革为，但是正因?yàn)樗δ茇S富，導(dǎo)致稍顯臃腫（二八定律：80%的時(shí)間里我們只會(huì)只用20%的功能）舵鳞，同時(shí)因?yàn)樗嬖谝远M(jìn)制格式保存震檩、軟件不兼容、格式不兼容蜓堕、難以進(jìn)行版本控制抛虏、難以實(shí)時(shí)分享預(yù)覽、難以多人協(xié)作等短板套才。而這恰恰是 GitBook + Markdown + Git 的長(zhǎng)處迂猴。
簡(jiǎn)單來(lái)說(shuō)，GitBook + Markdown + Git 帶來(lái)的好處有：
語(yǔ)法簡(jiǎn)單
兼容性強(qiáng)
導(dǎo)出方便
專(zhuān)注內(nèi)容
團(tuán)隊(duì)協(xié)作
所以背伴，如果你和我一樣沸毁，不滿(mǎn)足于傳統(tǒng)的寫(xiě)作方式，正在尋找一種令人愉悅的寫(xiě)作方式挂据，那么該嘗試使用 GitBook 啦以清！
當(dāng)然，GitBook 不是萬(wàn)能的崎逃，當(dāng)我們需要復(fù)雜排版時(shí)掷倔，依然需要依托于 Word 等工具。但不用擔(dān)心个绍，因?yàn)槲覀兛梢园?Markdown 格式的文檔導(dǎo)出為 Word 格式勒葱，再進(jìn)一步加工。
怎么辦巴柿？
怎么安裝
當(dāng)你聽(tīng)了我的慫恿凛虽，并決定嘗試使用 GitBook 的時(shí)候，首先面臨的問(wèn)題是 —— 如何搭建 GitBook 環(huán)境广恢？
因?yàn)?GitBook 是基于 Node.js凯旋，所以我們首先需要安裝 Node.js（下載地址：https://nodejs.org/en/download/），找到對(duì)應(yīng)平臺(tái)的版本安裝即可钉迷。
現(xiàn)在安裝 Node.js 都會(huì)默認(rèn)安裝 npm（node 包管理工具）至非，所以我們不用單獨(dú)安裝 npm，打開(kāi)命令行糠聪，執(zhí)行以下命令安裝 GitBook：
npm install -g gitbook-cli
1
安裝完之后荒椭，就會(huì)多了一個(gè) gitbook 命令（如果沒(méi)有，請(qǐng)確認(rèn)上面的命令是否加了 -g）舰蟆。
上面我推薦的是 GitBook + Typora + Git趣惠，所以你還需要安裝 Typora（一個(gè)很棒的支持 macOS狸棍、Windows、Linux 的 Markdown 編輯工具）和 Git 版本管理工具味悄。戳下面：
Typora 下載地址：https://typora.io/
Git 下載地址：https://git-scm.com/downloads
Typora 的安裝很簡(jiǎn)單草戈，難點(diǎn)在于需要翻墻才能下載（當(dāng)然你也可以找我要）。Git 的安裝也很簡(jiǎn)單侍瑟，但要用好它需要不少時(shí)間猾瘸，這里就不展開(kāi)了（再講下去怕你要跑啦~）。
怎么使用
想象一下丢习，現(xiàn)在你準(zhǔn)備構(gòu)建一本書(shū)籍，你在硬盤(pán)上新建了一個(gè)叫 mybook 的文件夾淮悼，按照以前的做法咐低，你會(huì)新建一個(gè) Word 文檔，寫(xiě)上標(biāo)題袜腥，然后開(kāi)始巴滋巴滋地筆耕见擦。但是現(xiàn)在有了 GitBook，你首先要做的是在 mybook 文件夾下執(zhí)行以下命令：
gitbook init
1
執(zhí)行完后羹令，你會(huì)看到多了兩個(gè)文件 —— README.md 和 SUMMARY.md鲤屡，它們的作用如下：
README.md —— 書(shū)籍的介紹寫(xiě)在這個(gè)文件里
SUMMARY.md —— 書(shū)籍的目錄結(jié)構(gòu)在這里配置
這時(shí)候，我們啟動(dòng)恭候多時(shí)的 Typora 來(lái)編輯這兩個(gè)文件了：
編輯 SUMMARY.md 文件福侈，內(nèi)容修改為：
# 目錄
* [前言](README.md)
* [第一章](Chapter1/README.md)
? * [第1節(jié)：衣](Chapter1/衣.md)
? * [第2節(jié)：食](Chapter1/食.md)
? * [第3節(jié)：住](Chapter1/住.md)
? * [第4節(jié)：行](Chapter1/行.md)
* [第二章](Chapter2/README.md)
* [第三章](Chapter3/README.md)
* [第四章](Chapter4/README.md)
1
2
3
4
5
6
7
8
9
10
11
12
然后我們回到命令行酒来，在 mybook 文件夾中再次執(zhí)行 gitbook init 命令。GitBook 會(huì)查找 SUMMARY.md 文件中描述的目錄和文件肪凛，如果沒(méi)有則會(huì)將其創(chuàng)建堰汉。
Typora 是所見(jiàn)即所得（實(shí)時(shí)渲染）的 Markdown 編輯器，這時(shí)候它是這樣的：
接著我們執(zhí)行 gitbook serve 來(lái)預(yù)覽這本書(shū)籍伟墙，執(zhí)行命令后會(huì)對(duì) Markdown 格式的文檔進(jìn)行轉(zhuǎn)換翘鸭，默認(rèn)轉(zhuǎn)換為 html 格式，最后提示 “Serving book on http://localhost:4000”戳葵。嗯就乓，打開(kāi)瀏覽器看一下吧：
當(dāng)你寫(xiě)得差不多，你可以執(zhí)行 gitbook build 命令構(gòu)建書(shū)籍拱烁，默認(rèn)將生成的靜態(tài)網(wǎng)站輸出到 _book 目錄生蚁。實(shí)際上，這一步也包含在 gitbook serve 里面邻梆，因?yàn)樗鼈兪?HTML守伸，所以 GitBook 通過(guò) Node.js 給你提供服務(wù)了。
當(dāng)然浦妄，build 命令可以指定路徑：
gitbook build [書(shū)籍路徑] [輸出路徑]
1
serve 命令也可以指定端口：
gitbook serve --port 2333
1
你還可以生成 PDF 格式的電子書(shū)：
gitbook pdf ./ ./mybook.pdf
1
生成 epub 格式的電子書(shū)：
gitbook epub ./ ./mybook.epub
1
生成 mobi 格式的電子書(shū)：
gitbook mobi ./ ./mybook.mobi
1
如果生成不了尼摹，你可能還需要安裝一些工具见芹，比如 ebook-convert〈览裕或者在 Typora 中安裝 Pandoc 進(jìn)行導(dǎo)出玄呛。
除此之外，別忘了還可以用 Git 做版本管理呀和二！在 mybook 目錄下執(zhí)行 git init 初始化倉(cāng)庫(kù)徘铝，執(zhí)行 git remote add 添加遠(yuǎn)程倉(cāng)庫(kù)（你得先在遠(yuǎn)端建好）。接著就可以愉快地 commit惯吕，push惕它，pull … 啦！
不是程序員的小伙伴可能不太喜歡用命令行废登，那其實(shí)版本管理這部分可以下載安裝 Git 或 GitHub 這些客戶(hù)端程序淹魄，在圖形界面上操作也是可以完成工作的。
---------------------
作者：阿基米東
來(lái)源：CSDN
原文：https://blog.csdn.net/lu_embedded/article/details/81100704
版權(quán)聲明：本文為博主原創(chuàng)文章堡距，轉(zhuǎn)載請(qǐng)附上博文鏈接甲锡！
