Github Pages
github pages可以當(dāng)做你或者你的項目的 Websites淤刃,那么我們可以知道 GitHub Pages 有兩種最基本的用法:
- 作為你自己(或者組織)的網(wǎng)站或者博客(訪問地址示例:http://username.github.io)
- 作為你某一個項目的網(wǎng)站(訪問地址示例:http://username.github.io/projectname)
如果是第二種的話部署的時候需要在源倉庫的基礎(chǔ)上再創(chuàng)建一個gh-pages的分支,然后部署的時候需要將在源倉庫生成的靜態(tài)文件單獨拎出來放到gh-pages分支上push上去凝危,整個操作流程比較麻煩,而travis-ci可以很方便幫們解決這個痛點热芹。
配置travis-ci
登錄 travis
登錄時使用GitHub賬號登錄梯投,此時為了讓travis獲取調(diào)用GitHub Api的權(quán)限需要在GitHub上生成一個token。
在github(https://github.com/settings/tokens) Settings/ Developer settings 新生成一個travis專用的token.
image
在travis 配置token環(huán)境變量
在你需要構(gòu)建的倉庫的設(shè)置里添加GITHUB_TOKEN環(huán)境變量嫂冻。
image
創(chuàng)建 配置文件
在你的github pages 項目里面新建.travis.yml配置文件。
language: node_js # 構(gòu)建所需的語言環(huán)境
node_js:
- "v11.14.0" # 對應(yīng)的版本
branches:
only:
- master # 構(gòu)建的分支
cache:
directories:
- node_modules # 依賴緩存的目錄
before_install:
- export TZ='Asia/Shanghai' # 設(shè)置時區(qū)
install:
- npm install -g gitbook-cli # 安裝編譯工具
script:
- gitbook build
deploy:
provider: pages
skip-cleanup: true
github-token: $GITHUB_TOKEN # github 上的token環(huán)境變量
local-dir: ./_book/ ## 根據(jù)情況自定義到靜態(tài)文件輸出目錄
target-branch: gh-pages
verbose: true
on:
branch: master
測試
在github page的項目里面修改一點東西塞椎,push到GitHub上去就會在travis上看到觸發(fā)build桨仿。
image
大概等個2min你會發(fā)現(xiàn)你的github pages 已經(jīng)更新了。