Gitbook合成电子书

原创
2018/04/13 10:21
阅读数 1.9K

一、简介

Git工具不仅能做版本控制管理还可以利用其拓展工具编写制作整洁电子图书,下面介绍下如何利用 该工具以及拓展工具制作电子书

二、制作电子书

1、整体流程

安装node.js>安装Gitbook>安装Gitbook编辑器>安装calibre>导出PDF。

根据个人喜好导出格式可以是HTML,亦或是PDF

2、分步流程

1.安装Node.js

由于GitBook是基于Node.js 开发的,所以依赖 Node.js 环境。如果您的系统中还未安装 Node.js,请点击下面的链接,根据你所使用的系统下载对应的版本。 如果已安装则略过本步骤。

Node.js 下载页面:https://nodejs.org/en/download/stable/

Windows 版和 Mac 版的 Node.js 都是常规的安装包,连续下一步安装即可。Lunix 版可以参照官方文档通过 yum、apt-get 之类的工具安装, 也可以通过源码包安装,如下所示

$ wget https://nodejs.org/dist/v5.4.1/node-v5.4.1.tar.gz
$ tar zxvf node-v5.4.1.tar.gz
$ cd node-v5.4.1
$ ./configure
$ make
$ make install

2.安装GitBook

打开“命令提示符”(Mac 系统打开“终端”)输入以下命令安装 GitBook

sudo npm install gitbook-cli -g

检查GitBook是否安装成功,打开“命令提示符”(Mac 系统打开“终端”)输入以下命令

sudo gitbook -V

3、创建电子书项目

新建一个目录,并进入该目录使用 gitbook 命令初始化电子书项目。 举个例子,现在要创建一个名为“MyFirstBook”的空白电子书项目,如下所示:

$ mkdir MyFirstBook

$ cd MyFirstBook

$ gitbook init

4、电子书内容

初始化后的目录中会出现“README.md(电子书简介文件)”和“SUMMARY.md(导航目录文件)”两个基本文件。 除此之外还可以手动新建其它“Glossary.md(书尾的词汇表)”、“book.json(电子书配置文件)”。 电子书的正文内容可以根据自己的喜好创建新的后缀为 .md 文件,如“section1.md”, 然后用MarkDown编写具体的文本内容即可。下面对这些文件分别做详细介绍。

README.md

此文件是简单的电子书介绍,可以把您所制作的电子书做一下简单的描述:

# 简介
这是我的第一本使用 GitBook 制作的电子书。

SUMMARY.md

此为电子书的导航目录文件,每当新增一个章节文件就需要向此文件中添加一条记录。 对于 Kindle 电子书来说,此文件所呈现的目录结构就是开头的目录内容和“前往”的目录导航。

# Summary  
* [简介](README.md)
* [第一章](section1/README.md)
* [第二章](section2/README.md)

如果需要“子章节”可以使用 Tab 缩进来实现(最多支持三级标题),如下所示:

# Summary

* [第一章](section1/README.md)
    * [第一节](section1/example1.md)
    * [第二节](section1/example2.md)
* [第二章](section2/README.md)
    * [第一节](section2/example1.md)

Glossary.md

对于电子书内容中需要解释的词汇可在此文件中定义。词汇表会被放在电子书末尾。其格式如下所示。

# 电子书
电子书是指将文字、图片、声音、影像等讯息内容数字化的出版物和
植入或下载数字化文字、图片、声音、影像等讯息内容的集存储和显示终端于一体的手持阅读器。

book.json。“book.json”是电子书的配置文件,可以看作是电子书的元数据, 比如 title、description、isbn、language、direction、styles 等。

{
    "title": "我的第一本電子書",
    "description": "用 GitBook 制作的第一本電子書!",
    "isbn": "978-3-16-148410-0",
    "language": "zh-tw",
    "direction": "ltr"
}

普通章节.md文件

普通章节.md文件可以使用您感觉顺手的文本编辑器编写。markdown的写法可以点击这里查看相关示例。 每编写一个 .md 文件,不要忘了在“SUMMARY.md”文件中添加一条记录。

电子书封面图片(可选)

GitBook 帮助文档建议封面图片的尺寸为 1800*2360 像素并且遵循建议:

没有边框
清晰可见的书本标题
任何重要的文字在小版本中应该可见
图片的格式为 jpg 格式。把图片重命名为“cover.jpg”放到电子书项目文件夹即可。

三、电子书合成

前面工作一切工作准备就绪后,我们就可以合成电子书。具体如下:

1.打开“命令提示符”(Mac 系统打开“终端”)执行如下命令:

$gitbook build

2.本地预览图书,执行如下命令

$gitbook serve

3.生成PDF格式文件

生成pdf格式文件需要安装calibre插件,玩过kindle的都知道, calibre是一款非常方便的开源电子书转换软件。在这里,我们也是用到ebook-convert这个插件 首先在calibre官网下载插件,下载链接:https://calibre-ebook.com/download 下载适合自己系统的版本。在Mac平台安装后,需要将 安装app添加到path中,具体执行命令如下:

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

4.合成电子书

执行命令

$gitbook pdf . xxx.pdf (注意命令后面空格与英文的.号,xxx为具体电子书名)

进入书籍目录,即可看到已经转换完成的PDF。

四、电子书上传与分享

将编写的电子书工程加入Git版本管理,这样可以维护以及管理该项目,具体如下

1.安装Git版本管理工具这里就不在赘述。

2.上传已存在电子书

$ mkdir MyFirstBook-Git
$ cd MyFirstBook-Git
$ git init
$ git pull https://git.gitbook.com/kindlefere/myfirstbook.git

3.把本地项目“MyFirstBook”中的所有内容拷贝到刚才新建的文件夹中,如上面的“MyFirstBook-Git”。然后使用Git命令把本地的项目上传到gitbook.com远程服务器。

$ git add -A
$ git commit -m "提交说明"
$ git remote add gitbook https://git.gitbook.com/kindlefere/myfirstbook.git
$ git push -u gitbook master

如果有自己内部搭建服务,上传一样

展开阅读全文
加载中

作者的其它热门文章

打赏
0
0 收藏
分享
打赏
0 评论
0 收藏
0
分享
返回顶部
顶部