MacOS使用GitBook制作电子书

目录

• 目录
• 一、简介
• 二、安装
  • 1. 安装node.js
  • 2. 安装gitbook
• 三、使用
• 四、常用命令
  • 1. 初始化 或 编辑目录
  • 2. 编辑内容之后编译书籍
  • 3. 启动web服务通过浏览器预览数据
  • 4. 生成电子书

一、简介

制作电子书的工具有很多，常用的免费工具推荐：

1. Sigil Ebook Editor
   • 应是最早的电子书制作软件（大概在10年左右就有了）
   • 可视化编辑内容、插入封面、编辑作者、生成目录
2. ePUBee Maker(ePUBee智多星)
   • 一款Microsoft Word的插件，将Word文档无损的存为电子书
   • 可导入电子书进行编辑，完美的编辑内容与元数据信息
3. GitBook
   • 同GitHub一样，将电子书作为一个工程，方便的控制版本
   • 提供GitBook Editor直接集成GitBook、Git、Markdown等功能

我选择的是GitBook，因为我是程序员，对git有不一样的信赖。

此文主要对在MacOS上使用GitBook做入门级说明。

二、安装

其实可以直接使用homebrew来安装，这里不做具体说明，命令如下：

brew cask install gitbook gitbook-editor

我采取的的方式是安装 gitbook-cli，具体方式如下：

1. 安装node.js

因为gitbook基于node.js，所以需要先安装node

# 可以先 brew search node 查看版本，然后安装你想要的版本
brew install node

查看版本，即安装是否成功

node -v
npm -v



2. 安装gitbook

# 注意 -g 参数
npm install -g gitbook-cli

安装之后会多出一个 gitbook 的命令，直接操作就可以了

三、使用

1. 新建文件夹test，作为一本书，并完成初始化

   mkdir test
   cd test
   
   # 初始化
   
   gitbook init
   

   第一次执行时间会比较长，看到如下内容即为成功
   

2. 执行后在test目录中会生成如下两个文件

   • README.md：书籍的介绍写在这个文件里
   • SUMMARY.md：书籍的目录结构在这里配置

   

3. 编辑这两个文件输入任意内容，目录格式举例
   

   注明：我这里使用的是 Typora 做为markdown编辑器

4. 编辑内容之后，回到终端，再次执行 gitbook init ，生成目录，如图：
   

   然后我们就可以编辑自己的电子书了

四、常用命令

1. 初始化 或 编辑目录

gitbook init

2. 编辑内容之后编译书籍

可以指定目录，默认当前

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

3. 启动web服务通过浏览器预览数据

默认端口4000

gitbook serve --port 1234 

4. 生成电子书

# 生成 PDF 格式的电子书
gitbook pdf ./ ./book_name.pdf

# 生成 epub 格式的电子书
gitbook epub ./ ./book_name.epub

# 生成 mobi 格式的电子书
gitbook mobi ./ ./book_name.mobi

初次生成电子书的时候，可能会出现如下错误：


解决方式：根据提示通过安装calibre-ebook来安装ebook-convert

1. 下载地址：https://calibre-ebook.com/dist/osx

2. 安装之后，建立软链

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