安装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 已经是可选的,选择后页面会刷新生成访问地址