gitbook简单安装和使用

Posted 2020-11-20 shengulong

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