gitbook 安装和使用

gitbook 安装和使用

1. 安装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

1. 查看安装

 # 查看node版本
 [root@ambari04 fdw]# node -v
 v10.22.0
 ​
 # 查看npm版本
 [root@ambari04 fdw]# npm -v 
 6.14.6

1. 安装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
 

1. 部署与使用

 # 初始化gitbook 仓库
 gitbook init 
 ​
 # 添加书籍栏目
 ​
 ​
 # 部署服务
 gitbook serve
 ​
 # 修改后重新构建服务
 gitbook build
 ​
 # 重新部署服务
 gitbook serve 
 ​

1. 书籍栏目添加

   • 初始化书籍后会生成两个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
    ​

2. web页面访问

   http://localhost:4000