gitbook 安装和使用
-
安装nodejs
wget https://nodejs.org/dist/v10.22.0/node-v10.22.0-linux-arm64.tar.xz
tar -xvJf node-v10.22.0-linux-arm64.tar.xz
ln -sf /runtimes/node-v10.22.0-linux-arm64/bin/node /usr/local/bin
ln -sf /runtimes/node-v10.22.0-linux-arm64/bin/npm /usr/local/bin
ln -sf /runtimes/node-v10.22.0-linux-arm64/bin/npx /usr/local/bin
-
查看安装
# 查看node版本
[root@ambari04 fdw]# node -v
v10.22.0
# 查看npm版本
[root@ambari04 fdw]# npm -v
6.14.6
-
安装gitbook
# 在安装完node.js并验证成功后，打开命令行，输入如下代码安装GitBook服务端
[root@ambari04 app]# npm install gitbook-cli -g
/runtimes/node-v10.22.0-linux-arm64/bin/gitbook -> /runtimes/node-v10.22.0-linux-arm64/lib/node_modules/gitbook-cli/bin/gitbook.js
+ gitbook-cli@2.3.2
updated 3 packages in 7.837s
# 验证gitbook安装， 在这里查看gitbook安装的时候，竟然找不到命令
[root@ambari04 app]# gitbook -v
-bash: gitbook: command not found
[root@ambari04 app]# gitbook -V
-bash: gitbook: command not found
[root@ambari04 app]# cd /runtimes/node-v10.22.0-linux-arm64/lib/node_modules/gitbook-cli/bin/
[root@ambari04 bin]# gitbook -V
-bash: gitbook: command not found
[root@ambari04 bin]# ls
gitbook.js
# 找到安装的js文件后，运行竟然可以了
[root@ambari04 bin]# ./gitbook.js -V
CLI version: 2.3.2
Installing GitBook 3.2.3
# 然后我就加了一个软连接，可以了
[root@ambari04 bin]# pwd
/runtimes/node-v10.22.0-linux-arm64/lib/node_modules/gitbook-cli/bin
[root@ambari04 bin]# ln -s /runtimes/node-v10.22.0-linux-arm64/lib/node_modules/gitbook-cli/bin/gitbook.js /usr/local/bin/gitbook
[root@ambari04 bin]# gitbook -V
CLI version: 2.3.2
GitBook version: 3.2.3
-
部署与使用
# 初始化gitbook 仓库
gitbook init
# 添加书籍栏目
# 部署服务
gitbook serve
# 修改后重新构建服务
gitbook build
# 重新部署服务
gitbook serve
-
书籍栏目添加
-
初始化书籍后会生成两个md文件（README.md）（SUMMARY.md）
-
在SUMMARY.md中添加目录，并将对应的文件放置到SUMMARY.md的同级目录下
# Summary
* [Introduction](README.md)
* [docker](docker_note.md)
-
目录结构
[root@ambari04 fdw]# ll
total 32
drwxr-xr-x 3 root root 4096 Sep 23 17:19 _book
-rw-r--r-- 1 root root 18079 Sep 23 17:16 docker_note.md
-rw-r--r-- 1 root root 16 Sep 23 17:13 README.md
-rw-r--r-- 1 root root 68 Sep 23 17:19 SUMMARY.md
-
-
web页面访问
