gitbook 安装和使用

Posted nulijiushimeili

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了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

 技术图片

 


































































以上是关于gitbook 安装和使用的主要内容,如果未能解决你的问题,请参考以下文章

gitbook 安装和使用

gitbook安装与使用

gitbook安装教程

如何用gitbook写文档并存到github上

gitbook简单教程

GitBook在Windows上安装及使用