如何使用travis-ci自动化构建部署GitHub Pages（gitbook）

Github Pages

github pages能够当作你或者你的项目的 Websites，那么咱们能够知道 GitHub Pages 有两种最基本的用法：

• 做为你本身（或者组织）的网站或者博客（访问地址示例：username.github.io）
• 做为你某一个项目的网站（访问地址示例：username.github.io/projectname…
  

若是是第二种的话部署的时候须要在源仓库的基础上再建立一个gh-pages的分支，而后部署的时候须要将在源仓库生成的静态文件单独拎出来放到gh-pages分支上push上去，整个操做流程比较麻烦，而travis-ci能够很方便帮们解决这个痛点。

配置travis-ci

登陆 travis

• travis-ci.org/（免费）

• travis-ci.com/（收费）
  

登陆时使用GitHub帐号登陆，此时为了让travis获取调用GitHub Api的权限须要在GitHub上生成一个token。 在github(github.com/settings/to…) Settings/ Developer settings 新生成一个travis专用的token.

在travis 配置token环境变量

在你须要构建的仓库的设置里添加GITHUB_TOKEN环境变量。

建立 配置文件

在你的github pages 项目里面新建.travis.yml配置文件。

language: node_js # 构建所需的语言环境
node_js:
 - "v11.14.0"  # 对应的版本
branches:
 only:
 - master    # 构建的分支
cache:
 directories:
 - node_modules # 依赖缓存的目录
before_install:
- export TZ='Asia/Shanghai'  # 设置时区
install:
 - npm install -g gitbook-cli # 安装编译工具
script:
- gitbook build
deploy:
 provider: pages
 skip-cleanup: true
 github-token: $GITHUB_TOKEN # github 上的token环境变量
 local-dir: ./_book/ ## 根据状况自定义到静态文件输出目录
 target-branch: gh-pages
 verbose: true
 on:
 branch: master
复制代码

测试

在github page的项目里面修改一点东西，push到GitHub上去就会在travis上看到触发build。

大概等个2min你会发现你的github pages 已经更新了。