记录gitbook部署github pages

安装node（目前测试高于10的版本会有问题，安装10即可）

这里使用nvm安装及配置
安装路径不能有空格和中文

安装gitbook-cli

1

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

gitbook初始化,SUMMARY(可选,可以将现有文件copy至此)

1

gitbook init

编写SUMMARY文档,book.json,执行构建编译

1

gitbook install

在gitbook 的项目里点击 settings ，找到 GitHub Pages

在本地环境中先将编译文档到 docs 目录（这里我新增了一个 Blog.md 文件） ，在 SUMMARY.md 中添加访问链接后可直接在左侧的目录树显示

命令行中键入gitbook build . docs，将文件都编译到 docs 目录下

然后将编译好的文件 PUSH 到远端仓库

1
2
3

$ git add *
$ git commit -m"Inital commit"
$ git push orgin master

此时，再去 Settings 里去设置 Pages 的 Source ,发现 master branch/docs folder 已经是可选的，选择后页面会刷新生成访问地址