之前使用 hexo 搭建自己的Github pages, 配置了很久的 next 主題, 寫了一段時(shí)間的文章，感覺棒棒的。 但是后面換了電腦，忘記備份數(shù)據(jù)，所有的markdown文件也沒有push到Github上，因?yàn)檫@些原因我就沒有寫過了。

最近打算重新拾起寫文章記錄的習(xí)慣，因?yàn)橹挥胁粩嗟目偨Y(jié)才能更好的理解學(xué)習(xí)。考慮到之前遇到的問題，加上有過gitlab ci的使用經(jīng)驗(yàn)，決定使用 travis-ci 自動(dòng)構(gòu)建github主頁。

travis-ci使用

travis-ci設(shè)置

打開travis-ci主頁，選擇右上角的 Sign in with Github, 使用你的 Github賬號登錄，進(jìn)入你的accounts頁面：

accounts

選擇你要使用travis-ci構(gòu)建的Github repository, 這里我開啟的是： wangming1993.github.com

wangming1993.github.com

點(diǎn)擊右下角的More options

More options

setting

travis-ci配置文件

travis-ci自動(dòng)build依賴于.travis.yml文件，文件會配置你的語言環(huán)境，版本，branch信息，環(huán)境變量，以及before_install, install, script,after_success 之類的hook.

這里我先列出我的travis.yml文件內(nèi)容，然后坐進(jìn)一步介紹：

language: node_js
node_js: stable
branches:
  only:
  - develop
before_install:
- npm install -g hexo
- npm install -g hexo-cli
install:
- npm install
script:
- hexo clean
- hexo generate
after_success:
  - cd ./public
  - git init
  - git config --global user.name 'wangming1993'
  - git config --global user.email 'wangming19932008@163.com'
  - git add .
  - git commit -m "generate static resources, triggerd by travis ci"
  - git push --force "https://wangming1993:${REPO_TOKEN}@${GH_REF}" master:master
env:
  global:
    - GH_REF: github.com/wangming1993/wangming1993.github.com.git

• language: node_js
  • 因?yàn)槭褂玫膆exo是通過npm安裝的，這就要求nodejs環(huán)境
• node_js: stable
  • 這個(gè)也很重要，不然低版本會報(bào)錯(cuò)
• branches
  • only develop, 因?yàn)閙aster分支我push的是作為Github pages需要的靜態(tài)文件的。
• before_install,install
  • 安裝hexo以及運(yùn)行hexo需要的一些node modules
• script
  • 這里指定構(gòu)建時(shí)的shell命令， hexo clean清除緩存，hexo generate將markdown文件轉(zhuǎn)換為html文件，并使用配置的主題。
• after_success
  • 可以用于指定構(gòu)建步驟成功后的執(zhí)行動(dòng)作，如將生成的靜態(tài)資源push到Github repository
• env
  • 用于定于一些環(huán)境變量，這些會通過export的方式供當(dāng)前shell引用

這里需要著重介紹一下push文件到Github的過程，我使用:

git push --force "https://wangming1993:${REPO_TOKEN}@${GH_REF}"

• wangming1993
  • 這是我的Github ID
• ${REPO_TOKEN}
  • Github的Personal access tokens， 因?yàn)檫@個(gè)涉及到安全性，不能push到Github,所以這個(gè)環(huán)境變量我是在travis-ci里面配置的
• {GH_REF}
  • 指定你push的Github repository, 配置的.travis.yml文件的env中

那么如何在travis-ci中配置環(huán)境變量呢？

首先明確的是這個(gè)環(huán)境變量的作用域是在你的具體repository中的，如我的repository是:wangming1993.github.com, 那么就需要在這個(gè)repository的setting里面進(jìn)行配置：

env setting

而關(guān)于Personal access tokens,你需要在你的Github中生成， 訪問： https://github.com/settings/tokens/new ， 選擇權(quán)限

scopes