Gitbook初体验

前言： Document Everything! 这是gitbook的宣传语，感觉很不错。 gitbook用合作代码的方式合作写文档，当然也可以个人使用作为版本控制。markdown语法即可，使用gitbook editor可以直接添加图片，个人觉得这个功能很好用。之前在github上写东西，图片要先上传获取外链再添加，很麻烦。
进入正题：

1. 由于要用npm安装gitbook，首先要有node环境，mac os下用brew install node，其他环境各不相同
2. 安装gitbook npm install -g gitbook-cli / cnpm install -g gitbook-cli
   推荐使用cnpm，npm一是速度慢，二是容易出错。 我用npm安装后虽然成功安装2.3.2但每次init都不过，报下载失败，关代理也不行，后来看到下载地址是cnpm...
   安装成功:

3. cd到目标文件夹路径下， gitbook init

ex: mac os use tree command
home brew...时间过长

现在就可以使用markdown工具写东西了. 我用的是Typora.
4. 编辑目录：测试可以使用多层嵌套目录[Sec](Sec/third/forth/fifth/README.md) ， 重新执行init就会更新目录结构，已生成的文件不会被覆盖。

5. 写好后就可以在本地预览啦。 gitbook serve

6. 可以选择git三连上传 git init git remote add git push -u origin master 也可以选择本地转换成网页 gitbook build [文档路径] [目标路径] 或者转成想要的文件格式 gitbook [目标格式] [文档路径] [目标路径].[目标格式] 需要安装ebook-convert。
   ex: brew cask install calibre mac os 安装ebook-convert

使用gitbook editor

支持多账号绑定，看起来很不错，比较尴尬的是要求chrome是最新版? 这么巧今天chrome发了新版?赶紧装一下

在经历各种bug （github授权失败，账号重置密码失败等。。）对比mac app和web，我觉得mac app。。bug有点多 放弃了 看介绍还是不错的 不过git也够我用了 就酱

完结

转载于:https://juejin.im/post/5cce7f646fb9a03242650fdd