基本使用
初始化书籍目录
gitbook init
README.md和SUMMARY.md是两个必须文件,README.md是对书籍的简单介绍,SUMMARY.md是书籍的目录结构
启动服务
运行一个 web 服务,通过http://localhost:4000 可以预览该书籍
gitbook serveserve 命令也可以指定端口:
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 级别
输出错误信息
最后更新于
这有帮助吗?