构建书籍

支持输出的格式

  • 静态站点:默认输出格式,可直接托管到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