一.在 Mac 環(huán)境上搭建 gitbook
1.安裝node.js纳击，在node.js官網(wǎng)下載，直接安裝穩(wěn)定版本帐我。
可以參考文章Mac下node版本管理工具nvmy以及npm簡(jiǎn)介槽卫，卸載問(wèn)題集合
2.檢測(cè) node.js 是否安裝成功
npm -v
3.安裝 gitboot 和命令行工具 -g 代表全局安裝
sudo npm install gitbook -g
sudo npm install -g gitbook-cli
4.檢測(cè)是否安裝成功 v 大寫(xiě)
gitbook -V
gitbook -version
更新 gitbook 命令行工具
sudo npm update gitbook-cli -g
卸載 GitBook 命令
sudo npm uninstall gitbook-cli -g
查看安裝位置
which gitbook
5.安裝 gitboot editor
方便編輯書(shū)籍
6.安裝calibre
calibre是一款非常方便的開(kāi)源電子書(shū)轉(zhuǎn)換軟件
7.將安裝的calibre放在應(yīng)用程序中,執(zhí)行
sudo ln -s /Applications/calibre.app/Contents/MacOS/ebook-convert /usr/local/bin
二.gitbook的使用
1.創(chuàng)建 mygitbook 文件夾止喷，作為第一本書(shū),并切換到這個(gè)文件夾下面
mkdir mygitbook && cd mygitbook
2.初始化 gitbook 工作目錄擦囊，創(chuàng)建必要的文件
gitbook init
README.md - 項(xiàng)目的介紹都寫(xiě)在這個(gè)文件里。
SUMMARY.md - GitBook 的目錄結(jié)構(gòu)在這里配置嘴办。
3.編輯目錄結(jié)構(gòu)
4.目錄建好以后在根目錄下執(zhí)行命令,只支持2級(jí)目錄：
gitbook init
編寫(xiě) gitbook 內(nèi)容,重新編譯
gitbook build
5.在根目錄執(zhí)行命令,啟動(dòng)服務(wù)：
gitbook serve
6.訪問(wèn)
用瀏覽器打開(kāi) http://localhost:4000/ 或 http://127.0.0.1:4000/ 查看顯示書(shū)籍的效果瞬场。結(jié)束預(yù)覽ctrl+c
7.生成電子書(shū),依賴(lài)于Calibre
gitbook mobi ./ ./MyFirstBook.mobi
三.將寫(xiě)好的文章推送到 github 上
注冊(cè) GitHub.com 賬號(hào),并新建一個(gè)項(xiàng)目。在“Setting（設(shè)置）”頁(yè)面獲取到“Git URL（Git 鏈接）”
在本地安裝 git
在本地新建一個(gè)文件夾涧郊，并通過(guò) Git 命令把剛才新建的遠(yuǎn)程項(xiàng)目抓取到本地
$ mkdir MyFirstBook-Git
$ cd MyFirstBook-Git
$ git init
$ git pull https://git.gitbook.com/kindlefere/myfirstbook.git
然后把本地項(xiàng)目“MyFirstBook”中的所有內(nèi)容拷貝到剛才新建的文件夾中贯被，如上面的“MyFirstBook-Git”。然后使用 Git 命令把本地的項(xiàng)目上傳到遠(yuǎn)程
$ git add -A
$ git commit -m "提交說(shuō)明"
$ git remote add gitbook https://git.gitbook.com/kindlefere/myfirstbook.git
$ git push -u gitbook master
修改內(nèi)容后只需要輸入以下 Git 命令即可
$ git add [修改的文件]
$ git commit -m "提交說(shuō)明"
$ git push -u gitbook master
參考文章：
