MacOS使用GitBook制作电子书

一、简介

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

Sigil Ebook Editor

应是最早的电子书制作软件(大概在10年左右就有了)

可视化编辑内容、插入封面、编辑作者、生成目录

ePUBee Maker(ePUBee智多星)

一款Microsoft Word的插件,将Word文档无损的存为电子书

可导入电子书进行编辑,完美的编辑内容与元数据信息

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

MacOS使用GitBook制作电子书

2. 安装gitbook # 注意 -g 参数 npm install -g gitbook-cli

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

三、使用

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

mkdir test cd test
# 初始化
gitbook init

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

MacOS使用GitBook制作电子书



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

README.md:书籍的介绍写在这个文件里

SUMMARY.md:书籍的目录结构在这里配置

MacOS使用GitBook制作电子书

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

MacOS使用GitBook制作电子书

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

编辑内容之后,回到终端,再次执行 gitbook init ,生成目录,如图:

MacOS使用GitBook制作电子书

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

四、常用命令 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

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

MacOS使用GitBook制作电子书

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

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

安装之后,建立软链

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

内容版权声明:除非注明,否则皆为本站原创文章。

转载注明出处:https://www.heiqu.com/wsxgyz.html