构建书籍

支持输出的格式

  • 静态站点:默认输出格式，可直接托管到GitHub Pages服务
  • PDF：安装gitbook-pdf
  • eBook：安装ebook-convert
  • 单HTML网页：一般用在转换为PDF或eBook的中间过程
  • JSON：一般用于电子书调试或元数据提取

GitBook.com构建

保存推送之后，将进行如下构建

  • website: 生成站点
  • json: 提取书籍的元数据信息(概要,简述等等)
  • epub: 生成可供下载的epub
  • pdf: 生成可供下载的pdf

本地构建

构建时处理文件规则：

  1. 处理范围： 根目录下所有文件，但不包括 .gitignore 中忽略的文件
  2. 转换方式： markdown文件转为html文件，其他文件不转换
  3. 生成路径： 所有文件(md文件==>HTML文件)和目录复制到 _book目录，路径保持不变

默认输出静态网站

输出PDF

  1. 安装插件 $ npm install -g gitbook-pdf
  2. 执行$ gitbook pdf

输出ePub

$ gitbook epub

输出MOBI

$ gitbook mobi

输出JSON

$ gitbook build