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/
刷新以后,就能看到内容已经改变;