目录

一、简介

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

  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

MacOS使用GitBook制作电子书的更多相关文章

  1. GitBook制作电子书详细教程(命令行版)

    GitBook 是一款基于 Node.js 开发的开源的工具,可以通过命令行的方式创建电子书项目,再使用 MarkDown 编写电子书内容,然后生成 PDF.ePub.mobi 格式的电子书,或生成一 ...

  2. 基于Git制作电子书 GitBook

    GitBook 详细介绍 GitBook 是一个基于 Node.js 的命令行工具,可使用 Github/Git 和 Markdown 来制作精美的电子书,GitBook 并非关于 Git 的教程. ...

  3. gitbook 制作 beego 参考手册

    安装gitbook工具 npm install -g gitbook-cli 从github 下载beego文档 https://github.com/beego/beedoc 创建目录 在 zh-c ...

  4. 使用 gitbook 制作自己的 html 文档

    使用 gitbook 制作自己的 html 文档 步骤如下 npm install gitbook-cli -g // 全局安装 gitbook-cli <span style="te ...

  5. 用word制作电子书最简捷模式 支持epub和mobi目录

    因为制作一本OCR的电子书,转到word编辑排版后,用calibre转成mobi发现没有目录,在网上查了资料研究了一下,终于解决了目录问题,根本不用将word文档转换为什么htm或txt,尤其是转换t ...

  6. 使用 Vue 和 epub.js 制作电子书阅读器

    ePub 简介 ePub 是一种电子书的标准格式,平时我看的电子书大部分是这种格式.在手机上我一般用"多看"阅读 ePub 电子书,在 Windows 上找不到用起来比较顺心的软件 ...

  7. 在macOS平台下制作SSL证书,免费域名通配符证、单域名证书、多域名证书教程

    1.安装 home-brew 2.安装 certbot 在终端执行下面命令 brew install certbot 3.制作SSL证书 第一步: 在终端执行下面命令 sudo certbot cer ...

  8. GitBook是一个命令行工具(Node.js库),我们可以借用该工具使用Github/Git和Markdown来制作精美的图书,但它并不是一本关于Git的教程哟。

    GitBook是一个命令行工具(Node.js库),我们可以借用该工具使用Github/Git和Markdown来制作精美的图书,但它并不是一本关于Git的教程哟. 支持输出多种格式 GitBook支 ...

  9. docker搭建gitbook服务

    Gitbook Gitbook简介 GitBook 是一个基于 Node.js 的命令行工具,可使用 Github/Git 和 Markdown 来制作精美的电子书,GitBook 并非关于 Git ...

随机推荐

  1. Win8 Metro(C#)数字图像处理--2.68图像最小值滤波器

    原文:Win8 Metro(C#)数字图像处理--2.68图像最小值滤波器 /// <summary> /// Min value filter. /// </summary> ...

  2. epplus输出成thml

    using System; using System.Collections.Generic; using System.Linq; using System.Web; using System.We ...

  3. InnoSetup提升系统管理员权限(通过破解方式修改?)

    PrivilegesRequired=admin 1 2 3 4 5   找到```INNO```安装目录下的```SetupLdr.e32```文件(其实就是一个exe程序),将程序中的```Man ...

  4. 从wireshark中学网络分析(一)

    http://blog.csdn.net/nk_test/article/details/56509688 http://blog.csdn.net/nk_test/article/details/5 ...

  5. 使用Disk2VHD进行P2V转换需要知道的一些事

    据不可靠统计,有「无数」工具可以实现物理机到虚拟机的(P2V)转换,虽然有很多此类工具都被开发商帖上了高价标签,但至少来自微软 Sysinternals 工具集中的 Disk2VHD 还是可以免费使用 ...

  6. ViewPager页面滑动,滑动到最后一页,再往后滑动则执行一个事件

    1.ViewPager在处理滑动事件的时候要用到OnPageChangeListener( 代码:this.viewPager.setOnPageChangeListener(new MyListen ...

  7. Python字典的合并与拆分

    1.字典的合并 dict1={1:[1,11,111],2:[2,22,222]} dict2={3:[3,33,333],4:[4,44,444]} dictMerged2=dict(dict1, ...

  8. HTML连载12-体验CSS

    一.通过标签来修改标签有哪些缺点: (1)需要记忆那些标签有哪些属性 (2)若该标签没有这个属性,则修改失败 (3)需求变更,需要修改大量的代码 (4)HTML标签及用于添加语义,与我们的定义不相符 ...

  9. screen命令使用简单说明

    首先用screen [-S]命令建立一个session,然后就可以在这个session中建立多个window了.使用screen [-S]可以建立多个session,而每个session又可以建立多个 ...

  10. 前端学习之Bootstrap学习

    一,Bootstrap简介 在前端世界,有个叫Bootstrap的家伙,,是twitter 开源出来的一套前端框架,利用Ta可以快速开发网站界面,它的特点就是比自己从头写简单,直观,方便,快捷,省劲. ...