文档工具GitBook使用

1、登录注册

地址：https://www.gitbook.com/

一、gitbook可以使用github帐号登陆，若是已经注册github能够直接使用github帐号登陆

二、若是是github帐号登陆，在登陆成功后，点击右上角的头像，选择‘account setting’去设置用户Email信息

 

 

 

2、建立文档

 

一、点击右上角的‘+New’建立新的BOOk， Public表示全部人可看，Private表示指定人可看

 

二、建立完成后，能够开始写文档，或者点击Settings->Collaborators邀请其余人一块儿来完善文档

 

 

3、windows客户端

因gitbook服务器在国外，在线写文档速度会比较慢，使用客户端进行编写，速度相对会快一些

客户端地址：http://download.csdn.net/detail/qq_16417155/9594632

使用gitbook帐号登陆后，能够同步在线的Book进行编写，写完后通Sysn同步到gitbook

 

4、生成HTML

一样的缘由，因gitbook站点在国外，阅读起来会比较慢，能够经过生成html部署到自有网站，加快显示速度

参考：

 

http://www.colobu.com/2014/10/09/gitbook-quickstart/

注：安装HTML工具前，请先安装nodejs

安装HTML生成工具:

1. 进入cmd

2. 执行：npm install gitbook -g

3. 执行：npm install -g gitbook-cli

生成HTML：

安装完生成工具以后，执行如下命令进行生成.

gitbook build 所在目录

好比个人book所在目录是 D:\hongw\Import\docs

那么执行 gitbook build D:\hongw\Import\docs

执行完成后，目录下的_book里就有咱们整本书的Html了。