Github Pages
github pages可以当做你或者你的项目的 Websites,那么我们可以知道 GitHub Pages 有两种最基本的用法:
- 作为你自己(或者组织)的网站或者博客(访问地址示例:http://username.github.io)
- 作为你某一个项目的网站(访问地址示例:http://username.github.io/projectname)
如果是第二种的话部署的时候需要在源仓库的基础上再创建一个gh-pages的分支,然后部署的时候需要将在源仓库生成的静态文件单独拎出来放到gh-pages分支上push上去,整个操作流程比较麻烦,而travis-ci可以很方便帮们解决这个痛点。
配置travis-ci
登录 travis
登录时使用GitHub账号登录,此时为了让travis获取调用GitHub Api的权限需要在GitHub上生成一个token。
在github(https://github.com/settings/tokens) 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 已经更新了。