Centos 7 下 GitBook 的安装与使用

文前说明

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

本文仅供学习交流使用，侵权必删。
不用于商业目的，转载请注明出处。

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

安装 Node.js

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
sudo make
sudo 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 book
cd book
gitbook init

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

ovirt-branding.md  README.md  SUMMARY.md

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

# 简介

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

2. 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)

3. Glossary.md，电子书内容中需要解释的词汇可在此文件中定义。词汇表会被放在电子书末尾。

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

4. book.json，电子书的配置文件。

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

5. 普通章节.md

• 每一个普通章节，都需要在 SUMMARY.md 中添加记录。

6. 电子书封面图片

• 建议封面图片的尺寸为 1800*2360 像素。
• 建议没有边框。
• 建议清晰可见的书本标题。
• 建议任何重要的文字在小版本中应该可见。
• 图片的格式为 jpg 格式。把图片重命名为 cover.jpg 放到电子书项目。

创建完成电子书，进行预览

gitbook serve

• 通过 http://localhost:4000 预览电子书内容，预览完毕后按 Ctrl + C 结束。

构建

1. 生成 html 文档。

gitbook build

2. 生成 mobi 电子书。

gitbook mobi ./ ./book.mobi

[root@localhost book]# gitbook mobi ./ ./book.mobi
info: 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- https://download.calibre-ebook.com/linux-installer.py | 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/_calibre
Installing bash completion to: /usr/share/bash-completion/completions/calibre
Setting up desktop integration...
Creating un-installer: /usr/bin/calibre-uninstall
Run "calibre" to start calibre

3. 生成 pdf 文档。

[root@localhost book]# gitbook pdf ./ ./book.pdf
info: 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