GitBook安装、配置、制作电子书(一)

GitBook安装、配置、制作电子书(一)

使用Git进行版本控制,并把项目托管到 GitBook.com(二)


文章目录

    • 一、yum安装node.js
        • 1、下载node.js
        • 2、yum安装node.js
        • 3、查看node.js版本
    • 二、安装 GitBook
        • 1、输入下面的命令来安装 GitBook
        • 2、查看版本检验是否安装成功
        • 3、第二次查看版本号
    • 三、发布并查看电子书内容
        • 1、创建目录,执行gitbook初始化
        • 2、将自己编辑好的文档更新到当前目录下
        • 3、编译文件( 将 *.md 文件生成 HTML 文档)
        • 4、运行GitBook项目
        • 5、查看运行结果
    • 四、实时更新文档内容
        • 1、在一个新的位置创建一个文件夹,并进行初始化
        • 2、在这里放入新的文件,并执行编译
        • 3、执行命令将编译后的文件复制到已经运行的GitBook目录下


一、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 -

GitBook安装、配置、制作电子书(一)_第1张图片

2、yum安装node.js

yum install -y nodejs

GitBook安装、配置、制作电子书(一)_第2张图片

3、查看node.js版本

npm -v			有则安装成功

查看版本号

二、安装 GitBook

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

npm install gitbook-cli -g

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

gitbook -V

首次,查看版本号会进行GitBook的安装操作;
安装完成后,再查看版本号即可;
GitBook安装、配置、制作电子书(一)_第3张图片

3、第二次查看版本号

gitbook -V

查看版本号

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

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

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

GitBook安装、配置、制作电子书(一)_第4张图片

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

GitBook安装、配置、制作电子书(一)_第5张图片

3、编译文件( 将 *.md 文件生成 HTML 文档)

gitbook build

GitBook安装、配置、制作电子书(一)_第6张图片

4、运行GitBook项目

gitbook serve

GitBook安装、配置、制作电子书(一)_第7张图片

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

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

5、查看运行结果

然后在浏览器中输入“http://localhost:4000”即可预览电子书内容,预览完毕后按 Ctrl + C 结束。
GitBook安装、配置、制作电子书(一)_第8张图片

四、实时更新文档内容

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

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

mkdir /english
cd /english/
gitbook init

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

gitbook build

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

cp -r _book/* /book/_book/

刷新以后,就能看到内容已经改变;

你可能感兴趣的:(Linux)