GitBook 安装使用

安装 Node.js

yum 方式安装 node.js

1) 安装 EPEL

yum install epel-release -y

2) 安装 node.js 和 npm

yum install nodejs npm --enablerepo=epel

3) 安装 node.js 管理工具

npm install -g n

4) 安装稳定版本的 node.js

本示例安装 node.js 的版本为12.16.3

n 12.16.3

5) 运行命令 n，选择已安装的 node.js 12.16.3 版本

6) 编辑环境配置文件

vim ~/.bash_profile

7) 按i进入编辑模式，在文件末尾添加下列信息

export N_PREFIX=/usr/local/bin/node

export PATH=$N_PREFIX/bin:$PATH

编辑完成后按 esc 键，输入 :wq 保存并退出文件。

8) 执行以下命令使配置生效

source ~/.bash_profile

9) 安装进程管理器，来控制 node.js 应用程序

进程管理器可以保持应用程序一直处于运行状态

npm install pm2 -g

10) 运行 node -v 和 npm -v 命令，检查 node.js 的版本

二进制解压安装 node.js

1) 下载 node.js 二进制包

cd /opt
wget https://nodejs.org/dist/v12.16.3/node-v12.16.3-linux-x64.tar.xz

2) 解压，更名

tar -xvf node-v12.16.3-linux-x64.tar.xz

mv node-v12.16.3-linux-x64 /usr/local/nodejs

3 建立软连接，变为全局

ln -s /usr/local/nodejs/bin/npm /usr/local/bin/

ln -s /usr/local/nodejs/bin/node /usr/local/bin/

4) 运行 node -v 和 npm -v 命令，检查 node.js 的版本

安装 Gitbook

安装

1）安装gitbook-cli工具，该工具可用于安装、使用多个不同的gitbook版本

npm install gitbook-cli -g

2）建立软连接，变为全局

ln -s /usr/local/nodejs/bin/gitbook /usr/local/bin

3）安装gitbook,输入gitbook -V 查看版本会自动安装gitbook程序

gitbook -V 

使用

1）建立书本目录，如：aluo_book

mkdir -p /usr/local/gitbook/aluo_book && cd /usr/local/gitbook/aluo_book

2）初始化操作

初始化成功后，aluo_book目录下会生成README.md和SUMMARY.md两个文件

gitbook init

# 查看文件是否生成
ll /usr/local/gitbook/aluo_book

3）使用markdown编辑器编辑好文本文件（.md文件）内容后，使用如下命令生成html文档

gitbook build

4）启动gitbook

gitbook serve

生成电子书文件

确定电子书没有问题后，可以通过输入以下命令生成 mobi 电子书：

gitbook mobi ./ ./MyFirstBook.mobi

如果出现以下错误提示，说明您还未安装 Calibre。由于 GitBook 生成 mobi 格式电子书依赖 Calibre 的 ebook-convert，所以请先下载安装 Calibre。

Error: Need to install ebook-convert from Calibre

Calibre 安装完毕后，对于 Mac OS X 系统，还需要先设置一下软链接：

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

再次运行转换命令，即可生成 mobi 格式电子书。

其他内容

为电子书章节加上序号，在电子书项目根目录新建book.json文件，内容如下

{
    "pluginsConfig": {
        "theme-default": {
             "showLevel": true
        }
    }
}

修改首页的Published with GitBook，在电子书项目根目录中创建_layouts->website->summary.html

​ summary.html内容请查看文件：_layouts\website\summary.html