如何基于Gitbook制作电子书

基于 Gitbook 制作电子书

安装gitbook 命令行工具

1

sudo npm install -g gitbook-cli

安装完之后，你可以检验下是否安装成功。

1

gitbook -V

常用命令

gitbook help 可以查看所有指令：

1
2
3
4
5
6
7
8

gitbook build #build a book
gitbook serve #serve the book as a website for testing
gitbook install # install all plugins dependencies
gitbook parse #parse and print debug information about a book
gitbook init #setup and create files for chapters
gitbook pdf #build a book into an ebook file
gitbook epub
gitbook mobi

编辑书籍

首先，进入一个目录，例如之前我们创建好的 gitbook，执行初始化命令

1

gitbook init

然后我们的 gitbook 空目录会多出两个文件：

1
2
3

gitbook/
├── README.md
└── SUMMARY.md

README.md 和 SUMMARY.md 是两个必须文件，README.md 是对书籍的简单介绍。SUMMARY.md 是书籍的目录结构。

1
2
3
4
5
6
7
8

# Summary

* [Introduction](README.md)

- [（一）千万别装](ch01.md)
- [（二）信任你的听众](ch02.md)
- [（三）听众到底要什么？](ch03.md)
- [（四）你我皆凡人](ch04.md)

书籍目录结构创建完成以后，就可以使用 gitbook serve 来编译和预览书籍了：

1

gitbook serve

gitbook serve 命令实际上会首先调用 gitbook build 编译书籍，完成以后会打开一个 web 服务器，监听在本地的 4000 端口

导出电子书

安装Calibre

gitbook 可以直接生成电子书，比如pdf、mobi、epub格式的，但是需要额外的组件支持

1
2
3
4
5
6
7
8
9
10
11
12
13

info: 7 plugins are installed
info: 6 explicitly listed
info: loading plugin "highlight"... OK
info: loading plugin "search"... OK
info: loading plugin "lunr"... OK
info: loading plugin "sharing"... OK
info: loading plugin "fontsettings"... OK
info: loading plugin "theme-default"... OK
info: found 41 pages
info: found 1 asset files

InstallRequiredError: "ebook-convert" is not installed.
Install it from Calibre: https://calibre-ebook.com

到 https://calibre-ebook.com/download 网站下载calibre安装。

安装完成后，如果是mac电脑，需要将ebook-convert 链接到 /usr/local/bin

1

sudo ln -s /Applications/calibre.app/Contents/MacOS/ebook-convert /usr/local/bin

导出电子书

1
2
3
4
5

#gitbook [电子书格式] [gitbook源码目录] [电子书生成的目录和文件名，默认为book]
gitbook mobi . ./bookname.mobi
gitbook pdf 
gitbook epub

最后就可以导入到电子书进行阅读了～～

高级特性

GitBook 配置

GitBook 允许您使用灵活的配置自定义您的电子书。

这些选项在 book.json 文件中指定。对于不熟悉 JSON 语法的作者，您可以使用 JSONlint 等工具验证语法。

封面

封面用于所有电子书格式。您可以自己提供一个，也可以使用 autocover plugin 生成一个。

要提供封面，请将 cover.jpg 文件放在书本的根目录下。添加一个 cover_small.jpg 将指定一个较小版本的封面。封面应为 JPEG 文件。

好的封面应该遵守以下准则：

• cover.jpg 的尺寸为 1800x2360 像素，cover_small.jpg 为 200x262
• 没有边界
• 清晰可见的书名
• 任何重要的文字应该在小版本中可见

更多配置见参考

1. GitBook.com 是使用 GitBook 格式创建和托管图书的在线平台。它提供托管，协作功能和易于使用的编辑器。

2. 如果你不希望使用 Gitbook 的仓库，而是想直接使用 Github 的仓库，也是可以的。

   首先，你需要绑定你的 Github 账号。最简单的方式当然就是登录 Gitbook.com 时使用 Github 账号登录方式了。否则，你也可以在 Account Settings 中的 Github 设置选项中去进行绑定。

3. 托管到GitHub pages

https://www.jianshu.com/p/f38d8ff999cb