安装gitbook
使用nvm管理node和npm版本
点击下载node 选择node-v12.20.1-x64.msi 版本
打开cmd 安装gitbook
npm install gitbook-cli -g
查看是否安装成功
gitbook -V
新项目用下面命令初始化
gitbook init
选择文件夹(已有项目)
gitbook install
安装插件,如果有问题,先使用命令单独安装有问题的插件,如下
npm install gitbook-plugin-xxxx(有问题的插件名)
再使用gitbook install
如果提示没有package.json,把package-lock.json复制改名即可
最后启动
gitbook serve
也可以用生成的_book文件夹里面的文件放到web服务器下也行。
编辑好md文件后,使用gitbook build
重新生成html文件
常用命令如下
gitbook init //初始化目录文件
gitbook help //列出gitbook所有的命令
gitbook --help //输出gitbook-cli的帮助信息
gitbook build //生成静态网页
gitbook serve //生成静态网页并运行服务器
gitbook build --gitbook=2.0.1 //生成时指定gitbook的版本, 本地没有会先下载
gitbook ls //列出本地所有的gitbook版本
gitbook ls-remote //列出远程可用的gitbook版本
gitbook fetch 标签/版本号 //安装对应的gitbook版本
gitbook update //更新到gitbook的最新版本
gitbook uninstall 2.0.1 //卸载对应的gitbook版本
gitbook build --log=debug //指定log的级别
gitbook builid --debug //输出错误信息