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

 

2. 查看安裝

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

3. 安裝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
 

 

3. 部署與使用

 # 初始化gitbook 倉庫
 gitbook init 
 ​
 # 添加書籍欄目
 ​
 ​
 # 部署服務
 gitbook serve
 ​
 # 修改后重新構建服務
 gitbook build
 ​
 # 重新部署服務
 gitbook serve 
 ​

4. 書籍欄目添加

   • 初始化書籍后會生成兩個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
    ​

    

5. web頁面訪問

   http://localhost:4000