如何使用 Gitbook 在本地创建电子书

Question

安装 gitbook 本地版本

下载 Node.js：https://nodejs.org/en/download/，安装 Node.js 到硬盘里，这里我安装到 D 盘的 nodejs 文件夹里，打开 cmd.exe，通过命令行进入 D 盘的 nodejs 文件夹。

通过 Node.js 安装 gitbook，在命令行输入 npm install -g gitbook-cli ，这样就安装了 gitbook。

开始建立一本书

建立一个文件夹，文件夹的名字就是书的名字，我在E盘建立了 pptMaking 的文件夹。

通过 cmd 命令行进入该文件夹， 输入 gitbook init，回车执行该命令

执行完后，看文件夹里新增了两个文件。

README.md —— 用来写书籍的介绍
SUMMARY.md —— 用来配置书籍的目录结构

使用 Typora 编辑 SUMMARY.md

# Summary

* [Introduction](README.md)
* [第一章](chapter1/README.md)
  * [第一节](chapter1/section1.md)
  * [第二节](chapter1/section2.md)
  * [第三节](chapter1/section3.md)
  * [第四节](chapter1/section4.md)
* [第二章](chapter2/README.md)
  * [第一节](chapter2/section1.md)
  * [第二节](chapter2/section2.md)
  * [第三节](chapter2/section3.md)
  * [第四节](chapter2/section4.md)
* [第三章](chapter3/README.md)
  * [第一节](chapter3/section1.md)
  * [第二节](chapter3/section2.md)
  * [第三节](chapter3/section3.md)
  * [第四节](chapter3/section4.md)
* [第四章](chapter4/README.md)
  * [第一节](chapter4/section1.md)
  * [第二节](chapter4/section2.md)
  * [第三节](chapter4/section3.md)
  * [第四节](chapter4/section4.md)
* [结束](end/README.md)

gitbook 初始化。回到命令行，在 pptMaking 文件下执行 gitbook init 命令。这时，gitbook 会查找 SUMMARY.md 文件中描述的目录和文件，如果没有则会新建文件和目录。所以说，你想批量建立目录和文件，这是一个好方法。

通过网页显示你的书籍。在命令行里执行 gitbook serve，命令会将 markdown 格式转换为 html 格式。命令里最后会提示 Serving book on http://localhost:4000，复制 http://localhost:4000 到浏览器里，会显示你的书 籍。

注意，如果命令行里显示缺失什么文件，而无法显示

输出你的书籍

输出的命令

可以通过执行 gitbook build 命令构建书籍，默认是生成静态网站输出到_book目录。

上面这一步包括在gitbook serve里。

通过build命令可以指定书籍路径

gitbook build [书籍路径] [输出路径]

生成 pdf 格式

gitbook pdf ./ ./pptMaking.pdf

生成 epub 格式

gitbook epub ./ ./pptMaking.epub

生成 mobi 格式

gitbook mobi ./ ./pptMaking.mobi

如果不能生成，需要下载 ebook-convert，或者在Typora中安装Pandoc进行导出。

将书籍 push 到github

在 mybook 目录下执行 git init 初始化仓库，执行 git romate add 添加远程仓库，然后 commit,push,pull

资源

• Typora 下载地址：https://typora.io/
• Git 下载地址：https://git-scm.com/downloads