gitbook

#gitbook

1 安装相关组件

安装node.js 请参见 Node.js Linux 安装与配置

2 操作系统环境准备

useradd gitbook
su - gitbook
vi ~/.bash_profile

export PATH=$PATH:/opt/node-v16.16.0-linux-x64/bin
source ~/.bash_profile

3 安装部署gitbook

3.1 安装gitbook 软件

npm install gitbook-cli

3.2 设置环境变量

vi ~/.bash_profile

export PATH=$PATH:/opt/node-v16.16.0-linux-x64/bin:/home/gitbook/node_modules/.bin

source ~/.bash_profile

3.3 初始化书籍

gitbook init
gitbook init ./directory
Note

如果想要指定目录创建，请使用第二条命令。

3.4 预览gitbook 服务器是否有问题

gitbook server

3.5 建立静态网页

gitbook build

4 使用beta版本

gitbook fetch beta
Warning

使用beta 版本可以体验到最新的软件，但是软件稳定性不足。

5 FQA

5.1 TypeError: cb.apply is not a function

5.1.1 报错信息

5.1.2 解决办法1

vi node_modules/npm/node_modules/graceful-fs/polyfills.js
--------------------input------------------------------
//  fs.stat = statFix(fs.stat)
//  fs.fstat = statFix(fs.fstat)
//  fs.lstat = statFix(fs.lstat)
Warning

目前还没解决。只有使用方法2.

5.1.3 解决办法2

用了 10.14.1版本的node就成功了。

wget https://nodejs.org/dist/v10.4.1/node-v10.4.1-linux-x64.tar.gz

5.2 npm ERR! code ECONNRESET

5.2.1 报错信息：

npm ERR! code ECONNRESET

5.2.2 解决办法：

npm config set proxy null #代理置为空

运行npm cache clean --force清理缓存

5.2.3 执行重新注册

npm config set registry http://registry.npmjs.org/
Warning

note:如果嫌安装依赖慢的话 可以使用国内淘宝镜像

npm config set registry https://registry.npm.taobao.org
npm install gitbook-cli

最后说一下，这个界面真是简陋，还是用回我的 wiki.js 吧。安装到这里也就没有兴趣再搞下去了。
gitbook|400