Gitbook 入门教程

gitbook 介绍

GitBook 是一个基于 Node.js 的命令行工具,可使用 Github/Git 和 Markdown 来制作精美的电子书。使用gitbook生成的电子书还可以直接上传到gitbook.com

gitbook.com使用

gitbook.com的使用很简单,这篇文章介绍的很详细,直接看吧,我就不复制了。

需要说明的有两个:

一个是gitbook默认没有开启生成pdf,epub等的选线,需要在设置中手动开启。

另外一个就是最主要的两个文件是readme.mdsummary.md

readme.md可以理解为是封面,主要是图书介绍之类的内容

summary.md 就是目录了,基于nodejs的gitbook命令会根据summary来生成文件。

nodejs 的gitbook使用

GitBook支持输出以下几种文档格式:

  • 静态站点:GitBook默认输出该种格式
  • PDF:需要安装gitbook-pdf依赖
  • eBook:需要安装ebook-convert

全局安装

1
npm install gitbook gitbook-cli -g

初始化项目

1
gitbook init

这里会直接生成 readme.mdsummary.md
如果要根据文件自动生成summary 需要安装 gitbook-summary

1
2
3
npm install gitbook gitbook-summary -g
# 安装完毕后进入内容目录输入
book sm

这样就会根据目录里面的内容自动生成summary.md

发布

1
2
gitbook build #生成html,可以直接提交到gitbook.com
gitbook [pdf]|[epub]|[mobi] #生成相应格式的图书

问题

如果在生成 pdf,epub或者mobi文件时产生错误 类似ebook-convert的,说明电脑里面没有安装Calibre 去官网下载后直接安装就可以了

我的图书

第一本书 中英双语NIV版圣经 欢迎star