前言: Document Everything! 这是gitbook的宣传语,感觉很不错。
gitbook用合作代码的方式合作写文档,当然也可以个人使用作为版本控制。markdown语法即可,使用gitbook editor可以直接添加图片,个人觉得这个功能很好用。之前在github上写东西,图片要先上传获取外链再添加,很麻烦。
进入正题:
- 由于要用npm安装gitbook,首先要有node环境,mac os下用
brew install node,其他环境各不相同 - 安装gitbook
npm install -g gitbook-cli/cnpm install -g gitbook-cli
推荐使用cnpm,npm一是速度慢,二是容易出错。 我用npm安装后虽然成功安装2.3.2但每次init都不过,报下载失败,关代理也不行,后来看到下载地址是cnpm...
安装成功:
gitbook init
ex: mac os use tree command
home brew...时间过长
现在就可以使用markdown工具写东西了. 我用的是Typora.
4. 编辑目录:测试可以使用多层嵌套目录[Sec](Sec/third/forth/fifth/README.md) , 重新执行init就会更新目录结构,已生成的文件不会被覆盖。
- 写好后就可以在本地预览啦。
gitbook serve
- 可以选择git三连上传
git initgit remote addgit push -u origin master也可以选择本地转换成网页gitbook build [文档路径] [目标路径]或者转成想要的文件格式gitbook [目标格式] [文档路径] [目标路径].[目标格式]需要安装ebook-convert。
ex:brew cask install calibremac os 安装ebook-convert
使用gitbook editor
支持多账号绑定,看起来很不错,比较尴尬的是要求chrome是最新版🙂 这么巧今天chrome发了新版😂赶紧装一下
在经历各种bug (github授权失败,账号重置密码失败等。。)对比mac app和web,我觉得mac app。。bug有点多 放弃了 看介绍还是不错的 不过git也够我用了 就酱
完结