一、介绍
GitBook是一个集编写、发布、托管功能于一身的易于使用电子书解决方案,它是发布内容和在内容上进行协作的最简单的解决方案。它与GitBook Editor有极为良好的集成配置。
二、环境搭建
1、安装要求
GitBook的安装既简单又方便,您的系统只需要满足下面这2个要求:
- NodeJS (建议使用版本大于4.0.0)
- Windows, Linux, Unix, or Mac OS X
2、安装NPM
安装GitBook的最好的方式是通过NPM,在命令行终端下,只需要执行以下命令即可安装成功:
$ npm install gitbook-cli -g
GitBook CLI
是一个可以在同一系统上安装和使用不同版本的GitBook的实用工具和程序,它将自动安装所需版本的GitBook并生成书籍。
3、创建书籍
GitBook能够生成一个电子书的模板:
$ gitbook init
如果您希望将书籍创建到新目录中,你可以通过以下命令来完成:
`gitbook init ./directory`
你可以通过使用以下方式去预览您的书籍:
$ gitbook serve
或者使用以下方式构建静态网站:
$ gitbook build
4、安装发布版本
gitbook cli
可以方便地下载和安装其他版本的gitbook,以便使用您的图书进行测试。
$ gitbook fetch beta
使用gitbook ls-remote
去远程查看可能需要安装的版本列表。
5、调试
你可以使用选项 --log=debug
和 --debug
去获取更好的错误信息(具有堆栈跟踪功能)。举例:
$ gitbook build ./ --log=debug --debug