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下来编辑

gitbook简单安装和使用-LMLPHP

mac客户端:这样使用其实也方便的

gitbook简单安装和使用-LMLPHP

3、离线写:

下载gitbook工具:

  • 安装npm、cnpm;
  • 安装cnpm/npm install gitbook-cli -g
  • 创建目录并初始化:SUMMARY是整个项目的目录,或者书的目录,参考下图
  • 编辑完启动:在test目录直接gitbook serve或者在test上层目录gitbook serve test

gitbook简单安装和使用-LMLPHPgitbook简单安装和使用-LMLPHP

gitbook简单安装和使用-LMLPHP

打开离线页面:

gitbook简单安装和使用-LMLPHP

这样离线完全编辑完或者中间随时,把你的本地内容上传到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

05-03 21:04