一.在 Mac 环境上搭建 gitbook
#1.安装node.js，在node.js官网下载，直接安装稳定版本。
https://nodejs.org/en/
#2.检测 node.js 是否安装成功
npm -v
#3.安装 gitboot 和命令行工具 -g 代表全局安装
sudo npm install gitbook -g
sudo npm install -g gitbook-cli
#4.检测是否安装成功 v 大写
gitbook -V
gitbook -version
#更新 gitbook 命令行工具
sudo npm update gitbook-cli -g
#卸载 GitBook 命令
sudo npm uninstall gitbook-cli -g
#查看安装位置
which gitbook
#5.安装 gitboot editor,方便编辑书籍
https://legacy.gitbook.com/editor/osx
#6.安装calibre,calibre是一款非常方便的开源电子书转换软件
https://calibre-ebook.com/download
#7.将安装的calibre放在应用程序中,执行
sudo ln -s /Applications/calibre.app/Contents/MacOS/ebook-convert /usr/local/bin
二.gitbook的使用
# 1.创建 mygitbook 文件夹，作为第一本书,并切换到这个文件夹下面
mkdir mygitbook && cd mygitbook
#2.初始化 gitbook 工作目录，创建必要的文件
gitbook init
#README.md - 项目的介绍都写在这个文件里。
#SUMMARY.md - GitBook 的目录结构在这里配置。
#3.编辑目录结构
#4.目录建好以后在根目录下执行命令,只支持2级目录：
gitbook init
#编写 gitbook 内容,重新编译
gitbook build
#5.在根目录执行命令,启动服务：
gitbook serve
#6.访问,用浏览器打开 http://localhost:4000/ 或 http://127.0.0.1:4000/ 查看显示书籍的效果。结束预览 ctrl+c
#7.生成电子书,依赖于Calibre
gitbook mobi ./ ./MyFirstBook.mobi
三.将写好的文章推送到 github 上
#注册 GitHub.com 账号,并新建一个项目。在“Setting（设置）”页面获取到“Git URL（Git 链接）”
#在本地安装 git
#在本地新建一个文件夹，并通过 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
#修改内容后只需要输入以下 Git 命令即可
$ git add [修改的文件]
$ git commit -m "提交说明"
$ git push -u gitbook master
