安装node.js
此nodejs安装方法仅适用于已编译版本,不适用源码版本
- 登录https://nodejs.org/dist/,下载对应版本的nodejs安装包,如:node-v10.16.3-linux-x64.tar.gz,接着使用tar命令解压
tar -zxvf node-v10.16.3-linux-x64.tar.gz
- 如果下载的是node-v10.16.3-linux-x64.tar.xz
xz -d node-v10.16.3-linux-x64.tar.xz
tar -xvf node-v10.16.3-linux-x64.tar
- 配置node全局属性
ln -s /usr/local/node/xxxxxx/bin/node /usr/local/bin/node
ln -s /usr/local/node/xxxxxx/bin/npm /usr/local/bin/npm
/usr/local/node/xxxxxx/ # nodejs 的绝对安装路径
- 校验
node -v # nodejs版本
npm -v # npm版本
安装gitbook
- 进入nodejs的bin目录,如:/usr/local/node/xxxxxx/bin,执行下面命令进行安装
npm install gitbook-cli -g
- 安装完成后,可以在nodejs的bin目录看到gitbook命令的软链接。添加gitbook命令的全局属性
ln -s /usr/local/node/xxxxxx/bin/gitbook /usr/local/bin/gitbook
- gitbook 校验
gitbook -V # 注意:V是大写
该步骤会检查gitbook安装情况,按照上面的步骤安装后并没有真正安装gitbook,而是会在这一步骤提示“ installing gitbook” ,安装完成后才显示gitbook版本,一直没有弄清楚为什么???有知道的大佬能解释下吗?多谢多谢!!
gitbook操作
- gitbook初始化,创建README.md和SUMMARY.md目录文件
gitbook init
- gitbook编译,将md文件编译后,生成静态html文件,用以前端页面展示
gitbook build # 仅编译,不启动服务
- 编译完成后,启动gitbook服务
gitbook serve # 启动服务,启动前会自动进行一次编译,再启动
- 启动后,系统会提示ip和port。一般Linux会提示访问 localhost:4000,这里的 localhost是Linux服务器的localhost,然后4000需要加入防火墙白名单。