3.3 图书输出
目前为止,Gitbook 支持如下输出:
- 静态 HTML,可以看作一个静态网站
- PDF 格式
- eBook格式
- 单个 HTML 文件
- JSON 格式
我们这里着重说下如何输出静态的 HTML 和 PDF 文件。
3.3.1 输出为静态网站
你有两种方式输出一个静态的网站:
1. 本地预览是自动生成
当你编辑好 gitbook 文档之后,你可以使用 gitbook 的命令来进行本地预览。
gitbook 会启动一个 4000 端口用于预览。
比如,通过 gitbook serve
来预览本文档:
你可以你的浏览器中打开这个网址: http://localhost:4000
你会发现,在你编辑的 gitbook项目的目录中会多一个 _book
目录,而这个目录中就是生成的本地预览的静态网站内容。
2. 使用 gitbook build 参数
与直接预览生成的静态网站不一样的时,使用这个命令,你可以将内容输出到你想要的目录。
Ps:gitbook build ./{book_name} --output=./{outputFolde}
gitbook build [当前路径] [输出路径]
gitbook build ./ doc # 默认打包输出到当前路径下面的 doc 文件夹中
注意:
打包成功之后,默认输出的文件放在 _book 文件夹里面,编译之后的入口: index.html
无论哪种方式,你都可以将这个静态网站打包,发布到你想要发布的服务器上,或者直接将这个打包文件给阅读者。
3.3.2 输出 PDF
输出为 PDF 文件,需要先安装 gitbook pdf
一般来说,不推荐安装全局环境,安装局部环境会比较好。
如果在安装 gitbook-pdf 时,觉得下载 phantomjs 包太慢的话,你可以到 phantomjs 的官方网站上去下载。
这个包的安装方式,参考其官网的说明文档。
当然,上面的方法,我试了,以失败告终。所以我换了一种方法。
Windows下使用 gitbook 生成PDF文件:https://www.aiyc.top/1969.html
然后,用下面的命令就可以生成 PDF 文件了。
如果,你已经在编写的 gitbook 当前目录,也可以使用相对路径。
然后,你就会发现,你的目录中多了一个名为 book.pdf
的文件。