文前说明

作为码农中的一员，需要不断的学习，我工作之余将一些分析总结和学习笔记写成博客与大家一起交流，也希望采用这种方式记录自己的学习之旅。

本文仅供学习交流使用，侵权必删。

不用于商业目的，转载请注明出处。

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

安装 Node.js

wget  zxvf node-v5.4.1.tar.gzcd node-v5.4.1./configuresudo makesudo make install

查看 node.js 是否安装成功

node -v

执行 ./configure 错误：WARNING: failed to autodetect C++ compiler version (CXX=g++)

需要安装 gcc

 sudo yum install gcc-c++

安装 GitBook

npm install gitbook-cli -g

gitbook 初始化

gitbook --version 

执行 gitbook --version 错误：Error: Cannot find module 'config-chain'cannot find module 模块, 安装该模块即可

npm install -g config-chain

创建电子书项目

mkdir bookcd bookgitbook init

创建好的项目目录中包含以下文件

ovirt-branding.md README.md SUMMARY.md

README.md，简单的电子书介绍。

# 简介这是使用 GitBook 制作的电子书。

SUMMARY.md，电子书的导航目录文件。

# 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，电子书的配置文件。

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

普通章节.md每一个普通章节，都需要在 SUMMARY.md 中添加记录。电子书封面图片建议封面图片的尺寸为 1800*2360 像素。建议没有边框。建议清晰可见的书本标题。建议任何重要的文字在小版本中应该可见。图片的格式为 jpg 格式。把图片重命名为 cover.jpg 放到电子书项目。创建完成电子书，进行预览

gitbook serve

通过 预览电子书内容，预览完毕后按 Ctrl + C 结束。构建生成 html 文档。

gitbook build

生成 mobi 电子书。

gitbook mobi ./ ./book.mobi[root@localhost book]# gitbook mobi ./ ./book.mobiinfo: 7 plugins are installed info: 6 explicitly listed info: loading plugin "highlight"... OK info: loading plugin "search"... OK info: loading plugin "lunr"... OK info: loading plugin "sharing"... OK info: loading plugin "fontsettings"... OK info: loading plugin "theme-default"... OK info: found 2 pages info: found 0 asset files info: >> generation finished with success in 6.1s ! info: >> 1 file(s) generated

构建 mobi 错误：InstallRequiredError: "ebook-convert" is not installed。Binary install 安装 calibre-ebook

sudo -v && wget -nv -O-  | sudo python -c "import sys; main=lambda:sys.stderr.write('Download failed\n'); exec(sys.stdin.read()); main()"Setting up command-line completion...Installing zsh completion to: /usr/share/zsh/site-functions/_calibreInstalling bash completion to: /usr/share/bash-completion/completions/calibreSetting up desktop integration...Creating un-installer: /usr/bin/calibre-uninstallRun "calibre" to start calibre

生成 pdf 文档。

[root@localhost book]# gitbook pdf ./ ./book.pdfinfo: 7 plugins are installed info: 6 explicitly listed info: loading plugin "highlight"... OK info: loading plugin "search"... OK info: loading plugin "lunr"... OK info: loading plugin "sharing"... OK info: loading plugin "fontsettings"... OK info: loading plugin "theme-default"... OK info: found 2 pages info: found 1 asset files info: >> generation finished with success in 7.6s ! info: >> 1 file(s) generated