如何使用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 已經更新了。