MacOS使用GitBook制作电子书

时间：2024-02-01 21:34:26

目录

一、简介

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

  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

相关文章