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也够我用了 就酱

完结