gitbook 安装和使用
Posted nulijiushimeili
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了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页面访问
以上是关于gitbook 安装和使用的主要内容,如果未能解决你的问题,请参考以下文章