Gitbook 搭建与使用

2022-10-27 15:44:47 浏览数 (1)

安装node

代码语言:javascript复制
yum install epel-release
yum install nodejs npm

安装gitbook

代码语言:javascript复制
npm install gitbook-cli -g

运行 gitbook -V 查看版本信息,安装 gitbook 出现下面的错误,是因为 node 版本太高了,安装低版本的 node

从下面的官网地址下载低版本的安装包 https://nodejs.org/en/download/releases/

再次运行 gitbook -V 就正常了

初始化

代码语言:javascript复制
# 新建一个目录
mkdir /data/gitbook
cd /data/gitbook

README.md 是说明文档 SUMMARY.md 是书的章节目录

启动服务

代码语言:javascript复制
gitbook serve >> /var/log/gitbook/serve.log 2>&1 &

# 启动时也可以手动指定端口
gitbook serve --port 80

gitbook会监听4000端口,浏览器访问http://ip:4000

编辑SUMMARY.md文件

GitBook 命令

代码语言:javascript复制
# 生成静态网页
gitbook build

# 生成静态网页并运行
gitbook serve

# 输出帮助信息
gitbook --help

# 生成静态网页进指定gitbook版本,如果没有则下载
gitbook build --gitbook=3.2.6

# 列出所有gitbook的版本
gitbook ls

# 列出远程可用的gitbook的版本
gitbook ls-remote

# 更新gitbook到最新版本
gitbook update

# 卸载对应版本的gitbook
gitbook uninstall 3.2.6

# 安装依赖
gitbook install

# 指定日志的级别
gitbook build --log=debug

# 输出错误信息
gitbook build --debug

0 人点赞