1、gitbook是用来写书的,支持markdown等
2、在线写
gitbook最新版地址:https://www.gitbook.com/account/ 免费用户只能有一个public和一个private项目
gitbook的老版地址:https://legacy.gitbook.com/
可以使用上面的两个网页,直接在线写书,但是网络,你得给力
如图所示,点击Read可以进入在线阅读模式;
点击Open in Desktop可以打开电脑的客户端(如果没有的话,会进入下载页面),客户端和在线编辑功能一样,这样,你就可以先线下编辑,然后定期同步一次就可以了。这样不用太依赖网络了
下面的是gitbook的git clone地址,你可以git clone下来编辑
mac客户端:这样使用其实也方便的
3、离线写:
下载gitbook工具:
- 安装npm、cnpm;
- 安装cnpm/
npm install gitbook-cli -g
- 创建目录并初始化:SUMMARY是整个项目的目录,或者书的目录,参考下图
- 编辑完启动:在test目录直接gitbook serve或者在test上层目录gitbook serve test
打开离线页面:
这样离线完全编辑完或者中间随时,把你的本地内容上传到github或者gitbook上去进行发布即可
遗留问题:gitbook没有github那样的ssh公钥方式免密git clone,因此每次都要输入帐号和密码,但是我又没有注册gitbook的帐号,使用github直接登录的,所以没办法使用git clone之类的操作,好纠结
参考:
https://yuzeshan.gitbooks.io/gitbook-studying/content/index.html
参考源码:https://github.com/yuzeshan/gitbook-studying