2.4. 生成格式
完成书籍撰写,就可以生成需要的格式进行发布了。
HTML网页版本
在书籍项目目录的跟目录输入 gitbook install
,会自动安装必要的插件与书籍项目指定的插件。
指定插件是由 book.json
这个文件控制,这里没有用到,因此GitBook只会预先安装一个 high light 插件,用来显示书中插入程序代码区段。(使用 gitbook serve
还会自动启用另一个 livereload 插件,用于自动重载更新后的页面。)
整个静态格式书籍会放在 _book
目录下,若是不需要通过浏览器查看,也可使用 gitbook build
构建。
可以把整个html目录上传到自己的网站空间,就连GitHub Pages 空间都可以用。
制作电子书文件
从书籍项目根目录执行:
gitbook epub
制作 ePub 电子书gitbook mobi
制作 Kindle 电子书gitbook pdf
制作PDF电子书
完整命令
也可以从书籍项目外部执行,完整命令是:
gitbook epub [book] [output]
例如 gitbook mobi ~/ebook/mybook ~/Desktop/mybook.mobi
。制作电子书制定 output
时需包含完整的路径和文件名称。
想要将静态网站建立到指定目录,可以这样输入:
gitbook build --output=/site/mybook
输入 gitbook help
可以看到帮助信息。
结论
GitBook 可以说是未来出版的一个发展趋势,而且还在持续进化之中。
一般使用桌面客户端编辑器,或在线编辑器即可,只要注意草稿分支的使用技巧,完全不懂技术也能制作各种电子书籍。不怕终端命令、略懂 Node 和 NPM 的,可搭配 gitbook-cli
和 Calibre 则可以使用 GitBook 的所有功能。