前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >GitBook安装、配置、制作电子书(一)

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

作者头像
ha_lydms
发布2023-08-09 20:38:27
4200
发布2023-08-09 20:38:27
举报
文章被收录于专栏:学习内容学习内容

一、yum安装node.js

1、下载node.js

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

V10.x:

代码语言:javascript
复制
curl --silent --location https://rpm.nodesource.com/setup_10.x | bash -

V8.x:

代码语言:javascript
复制
curl --silent --location https://rpm.nodesource.com/setup_8.x | bash -

V7.x:

代码语言:javascript
复制
curl --silent --location https://rpm.nodesource.com/setup_7.x | bash -
下载nodejs
下载nodejs
2、yum安装node.js
代码语言:javascript
复制
yum install -y nodejs
安装nodejs
安装nodejs
3、查看node.js版本
代码语言:javascript
复制
npm -v			有则安装成功
查看版本号
查看版本号

二、安装 GitBook

1、输入下面的命令来安装 GitBook
代码语言:javascript
复制
npm install gitbook-cli -g
2、查看版本检验是否安装成功
代码语言:javascript
复制
gitbook -V

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

首次安装
首次安装
3、第二次查看版本号
代码语言:javascript
复制
gitbook -V
查看版本号
查看版本号

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

1、创建目录,执行gitbook初始化
代码语言:javascript
复制
mkdir /book/			创建gitbook文件夹;
cd /book				到达文件夹内容;
gitbook init			gitbook初始化;
创建文件夹
创建文件夹
2、将自己编辑好的文档更新到当前目录下
在这里插入图片描述
在这里插入图片描述
3、编译文件( 将 *.md 文件生成 HTML 文档)
代码语言:javascript
复制
gitbook build
编译文档
编译文档
4、运行GitBook项目
代码语言:javascript
复制
gitbook serve
运行项目
运行项目

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

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

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

结果展示
结果展示

四、实时更新文档内容

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

1、在一个新的位置创建一个文件夹,并进行初始化
代码语言:javascript
复制
mkdir /english
cd /english/
gitbook init
2、在这里放入新的文件,并执行编译
代码语言:javascript
复制
gitbook build
3、执行命令将编译后的文件复制到已经运行的GitBook目录下
代码语言:javascript
复制
cp -r _book/* /book/_book/

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

五、出现问题

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

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

代码语言:javascript
复制
https://zhuanlan.zhihu.com/p/367562636
本文参与 腾讯云自媒体同步曝光计划,分享自作者个人站点/博客。
原始发表:2023-07-21,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 作者个人站点/博客 前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体同步曝光计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 一、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目录下
                              • 五、出现问题
                                • 1、Gitbook错误"cb.apply is not a function"的解决办法
                                领券
                                问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档