基本使用

初始化书籍目录

gitbook init

README.mdSUMMARY.md 是两个必须文件, README.md 是对书籍的简单介绍, SUMMARY.md 是书籍的目录结构

启动服务

运行一个 web 服务,通过http://localhost:4000 可以预览该书籍

gitbook serve

serve 命令也可以指定端口:

gitbook serve --port 2333

编译和预览书籍

注: gitbook serve 命令实际上会首先调用 gitbook build 编译书籍,完成以后会打开一个 web 服务器,监听在本地的 4000 端口

生成静态网页

执行 gitbook build 命令构建书籍,默认将生成的静态网站输出到 _book 目录。实际上,这一步也包含在 gitbook serve 里面,因为它们是 HTML,所以 gitbook 通过 Node.js 提供服务了。

gitbook build #生成静态网页

可以生成 PDF 格式的电子书:

生成 epub 格式的电子书:

生成 mobi 格式的电子书:

注:如果生成不了,还需要安装工具ebook-convert,安装好后,还需要执行以下命令

Debugging

可以获取更好的错误信息 (使用堆栈跟踪)

输出帮助信息

生成静态网页

生成静态网页并运行服务器

生成指定 gitbook 的版本

列出本地所有的 gitbook 版本

列出远程可用的 gitbook 版本

安装对应的 gitbook 版本

更新到 gitbook 的最新版本

卸载对应的 gitbook 版本

指定 log 级别

输出错误信息

最后更新于

这有帮助吗?