GitBook安装、配置、制作电子书（一）

GitBook安装、配置、制作电子书（一）

使用Git进行版本控制，并把项目托管到 GitBook.com（二）

---

---

一、yum安装node.js

1、下载node.js

有多个稳定版本的Node.js可用，您可以根据您的选择安装所需的版本；

V10.x：

curl --silent --location https://rpm.nodesource.com/setup_10.x | bash -

V8.x：

curl --silent --location https://rpm.nodesource.com/setup_8.x | bash -

V7.x：

curl --silent --location https://rpm.nodesource.com/setup_7.x | bash -

2、yum安装node.js

yum install -y nodejs

3、查看node.js版本

npm -v			有则安装成功

二、安装 GitBook

1、输入下面的命令来安装 GitBook

npm install gitbook-cli -g

2、查看版本检验是否安装成功

gitbook -V

首次，查看版本号会进行GitBook的安装操作；
安装完成后，再查看版本号即可；

3、第二次查看版本号

gitbook -V

三、发布并查看电子书内容

1、创建目录，执行gitbook初始化

mkdir /book/			创建gitbook文件夹；
cd /book				到达文件夹内容；
gitbook init			gitbook初始化；

2、将自己编辑好的文档更新到当前目录下

3、编译文件（ 将 *.md 文件生成 HTML 文档）

gitbook build

4、运行GitBook项目

gitbook serve

后台运行GitBook文档，并将日志打印到指定文件

nohup gitbook serve >book.log &

nohup： 	意思是不挂断运行命令,当账户退出或终端关闭时,程序仍然运行；
			当用 nohup 命令执行作业时，缺省情况下该作业的所有输出被重定向到nohup.out的文件中，除非另外指定了输出文件。
>book.log：	将日志输出到指定文件
&：			代表在后台运行，当前ssh窗口不被锁定，但是当窗口关闭时，程序中止运行。

5、查看运行结果

然后在浏览器中输入“http://localhost:4000”即可预览电子书内容，预览完毕后按 Ctrl + C 结束。

四、实时更新文档内容

    当GitBook运行起来以后，假如后期有接口需要更新，每次都需把GitBook都关闭再进行编译运行；
    这时候GitBook的一个特性就表现出来了，浏览页面时，都是从编译生成的(_book)目录下获取文本内容的，换言之就是，只要改变(__book)目录下的文件，页面内容也会随之改变；

1、在一个新的位置创建一个文件夹,并进行初始化

mkdir /english
cd /english/
gitbook init

2、在这里放入新的文件，并执行编译

gitbook build

3、执行命令将编译后的文件复制到已经运行的GitBook目录下

cp -r _book/* /book/_book/

刷新以后，就能看到内容已经改变；

五、出现问题

1、Gitbook错误"cb.apply is not a function"的解决办法

Gitbook错误"cb.apply is not a function"的解决办法

https://zhuanlan.zhihu.com/p/367562636