Mac上安装配置gitboook

新接触的时候要大概理解这个软件的意义，是基于git的分布式文本编辑。一个组织中的多个人，合作写一个文本，大家都可以使用独立的分支，可以分开可以合并，大家都是master也都是origin

安装Gitbook的主要流程如下：

安装node.js>安装Gitbook>安装Gitbook编辑器>安装calibre>导出PDF。

一 安装nodejs

点击下载nodejs

我们这里下载nodejs 是为了通过npm安装gitbook

一路next，nodejs安装成功了。

在终端输入 npm -v 检测是否安装成功：

我的是10.13.0版本

使用sudo指令安装gitbook客户端 Mac要加sudo指令

sudo npm install gitbook-cli -g 

-g是全局安装的意思，也可以不加-g，但是建议大家还是加-g，我去掉-g安装了一次，也成功了，但是在终端使用gitbook -V查看的时候发现根本没安装，这是我遇到的坑最多的地方。

但是到这里我又出现问题了，因为npm install是从外网下载，所以很慢，一直出错下不下来，可以碰碰运气看看能不能成功安装。

解决办法是，修改npm的资源镜像连接，使用的是淘宝的镜像

 npm config set registry http://registry.npm.taobao.org

算是成功了吧，但现在还是在下载gitbook中，Installing Gitbook 3.2.3 。。。 稍等片刻，就下好了。

 

二 安装gitbook编辑器

点击下载gitbook editor 官网会根据你的系统自动帮你选择下载版本。

使用Gitbook桌面编辑器能够很方便的进行文章书写，终端环境下的Gitbook只是为了生成HTML文档与PDF文档而使用的。

我们可以随意在一个地方创建一个文件夹

mkdir mybook

初始化这本书

gitbook init

初始化成功后，mybook文件夹中会自动创建两个文件，README.md（说明书）和SUMMARY.md（书的目录）

创建好一本书之后，然后可以用终端生成HTML

gitbook build

此时又会多出_book文件夹，_book文件夹然后使用命令可以在本地进行预览，命令是

gitbook serve

出现以下信息，就说明成功了，可以输入地址栏进行本地预览

 

 

三 安装gitbook editor

gitbook editor安装路径

我想通过登录github来关联gitbook，但是由于网络问题，gitbook editor始终没有登陆成功。

所以我干脆放弃登录，直接点击do that later

我们这时就成功接入了编辑器的编辑界面，我们可以先在本地编辑好一本书，然后将书跟自己的git账号关联一起，操作步骤如下：

填写自己的仓库路径，然后点击Save并上传Public，可以登录自己的git账号查看是否已经上传成功。

可以看到，已经上传成功。

 

四 安装calibre(转换文件格式的插件)

下载链接：https://calibre-ebook.com/download。下载适合自己系统的版本。

执行一个命令

sudo ln -s /Applications/calibre.app/Contents/MacOS/ebook-convert /usr/local/bin

ln命令是一个非常重要命令，它的功能是为某一个文件在另外一个位置建立一个同步的链接。

当我们需要在不同的目录，用到相同的文件时，我们不需要在每一个需要的目录下都放一个必须相同的文件，我们只要在某个固定的目录，放上该文件，然后在 其它的目录下用ln命令链接（link）它就可以，不必重复的占用磁盘空间。

最后在终端进入到自己写的书目录下，执行 gitbook pdf 就可以成功将一本书转化成pdf格式，除了pdf格式，还有mobi、epub格式。

 

git clone 克隆代码源

git pull 更新代码源到本地

gitbook init 初始化  -> 生成目录 说明书

gitbook build 创建目录_book文件

gitbook serve 将书部署到服务器，预览书