上一篇文章我們說了怎么在我們的電腦上安裝和使用Hexo滤愕,這次我想介紹下怎么將hexo部署到github上,這篇文章中我將介紹兩種方法逼肯。
介紹這兩種方法之前,我們先將準(zhǔn)備工作做一下膜钓。
github準(zhǔn)備工作
注冊(cè)賬號(hào)
如果你已經(jīng)有了github賬號(hào),這一步可以忽略卿嘲,注冊(cè)的細(xì)節(jié)我就不多說了颂斜。
配置
新建Repository
創(chuàng)建yourname.github.io,打勾表示名稱可用
第一種方法
生成網(wǎng)站
$ hexo generate
此時(shí)會(huì)將/source的.md文件生成到/public中拾枣,形成網(wǎng)站的靜態(tài)文件沃疮。
本地服務(wù)器
$ hexo server
輸入http://localhost:4000 即可查看網(wǎng)站。
可修改:
$ hexo server -p 3000
此時(shí)梅肤,輸入http://localhost:3000 查看網(wǎng)站司蔬。
部署網(wǎng)站
第一步需要在_config.yml中配置你所要部署的站點(diǎn):
# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
type: git
repository: https://github.com/mamadown/mamadown.github.io.git
branch: master
部署命令
$ hexo deploy
部署網(wǎng)站之前需要生成靜態(tài)文件,也可以用$ hexo generate -d直接生成并部署姨蝴。
到此為止完成網(wǎng)站的雛形俊啼。輸入yourname.github.io可訪問博客主頁。例如:http://atecher.github.io/ 左医。
部署的時(shí)候有可能會(huì)出錯(cuò)授帕,別急,加這一步操作就ok了浮梢。
$ npm install hexo-deployer-git --save
PS:這種方式跛十,如果需要多臺(tái)電腦之間操作blog,會(huì)很麻煩秕硝。個(gè)人建議使用第二種方式芥映。
第二種方法
第一種方法,我們需要每次寫完文章后自己進(jìn)行編譯靜態(tài)文件并部署到github上远豺。那么能不能借助免費(fèi)的開源持續(xù)集成構(gòu)建項(xiàng)目來完成自動(dòng)編譯部署呢屏轰?
能,那就是Travis CI憋飞。
什么是Travis CI
Travis CI 是目前新興的開源持續(xù)集成構(gòu)建項(xiàng)目霎苗,它與jenkins,Go的很明顯的特別在于采用yaml格式榛做,同時(shí)他是在在線的服務(wù)唁盏,不像jenkins需要你本地打架服務(wù)器,簡(jiǎn)潔清新獨(dú)樹一幟检眯。目前大多數(shù)的github項(xiàng)目都已經(jīng)移入到Travis CI的構(gòu)建隊(duì)列中厘擂,據(jù)說Travis CI每天運(yùn)行超過4000次完整構(gòu)建。對(duì)于做開源項(xiàng)目或者github的使用者锰瘸,如果你的項(xiàng)目還沒有加入Travis CI構(gòu)建隊(duì)列刽严,那么我真的想對(duì)你說out了。
github代碼位置
使用Travis CI需要在github上創(chuàng)建兩個(gè)分支避凝,一個(gè)是默認(rèn)的master舞萄,還有一個(gè)是blog-source分支眨补。
master:博客的靜態(tài)文件,也就是hexo生成后的HTML文件倒脓,因?yàn)橐褂肎ithub Pages服務(wù)撑螺,所以他規(guī)定的網(wǎng)頁文件必須是在master分支。
blog-source:是博客的源代碼崎弃,我們需要將hexo的代碼上傳到這個(gè)分支甘晤。
我們只需要將你的blog clone到本地,在blog-source分支寫blog饲做,寫完之后it push到github线婚,然后Travis自動(dòng)構(gòu)建,構(gòu)建完成后自動(dòng)推送到Github上的master分支下盆均。
啟用要構(gòu)建的項(xiàng)目
首先如果你要使用Travis CI塞弊,你必須要GIthub賬號(hào)(好像Travis CI只支持構(gòu)建github的項(xiàng)目)和一個(gè)項(xiàng)目。
使用Github賬號(hào)登錄Travis CI官網(wǎng)缀踪,如下圖:
登錄完后會(huì)進(jìn)入如下界面
當(dāng)然如果你以前沒用使用過,所以你登錄完是沒有上圖紅框內(nèi)的內(nèi)容的虹脯,這里是因?yàn)槲以趯戇@篇博客前已經(jīng)使用了驴娃,所以會(huì)有這些內(nèi)容。
接下來我們點(diǎn)擊My Repositories旁邊的+循集,意思是添加一個(gè)要自動(dòng)構(gòu)建的倉庫唇敞,點(diǎn)擊后就會(huì)來到如下界面:
可以看到這個(gè)界面會(huì)顯示當(dāng)前github賬號(hào)的所以項(xiàng)目,如果沒有顯示咒彤,點(diǎn)擊右上角的“Sync account”按鈕疆柔,就可以同步過來了。
下一步肯定是要開啟你需要構(gòu)建的倉庫镶柱,大家可以看到紅框圈起來的部分旷档,就是我開啟了我的博客。
開啟后我們還需要進(jìn)行一些配置歇拆,操作如下:
點(diǎn)擊紅框的那個(gè)菜單按鈕鞋屈,就會(huì)出現(xiàn)這樣的下拉菜單,我們選擇設(shè)置故觅,來到這個(gè)界面厂庇,我們按照如下勾選:
Build only if .travis.yml is present:是只有在.travis.yml文件中配置的分支改變了才構(gòu)建;
Build branch updates:當(dāng)推送完這個(gè)分支后開始構(gòu)建输吏;
到這一步权旷, 我們已經(jīng)開啟了要構(gòu)建的倉庫,但是還有個(gè)問題就是贯溅,構(gòu)建完后拄氯,我們?cè)趺磳⑸傻奈募扑偷絞ithub上呢躲查,如果不能推送那我們就不需要倒騰一番來使用Travis CI服務(wù)了,我們要的結(jié)果就是坤邪,我們只要想github一push熙含,他就自動(dòng)構(gòu)建并push靜態(tài)文件到github pages呢,那么下面要解決的就是Travis CI怎么訪問github了艇纺。
在Travis CI配置Github的Access Token
標(biāo)題已經(jīng)說得很明白了吧怎静,我們需要在Travis上配置Access Token,這樣我們就可以在他構(gòu)建完后自動(dòng)push到github pages了黔衡。
在github上生成Access Token
首先我們來到github的設(shè)置界面蚓聘,點(diǎn)擊到Personal access tokens頁面,點(diǎn)擊右上角的Generate new token按鈕會(huì)重新生成一個(gè)盟劫,點(diǎn)擊后他會(huì)叫你輸入密碼夜牡,然后來到如下界面,給他去一個(gè)名字侣签,下面是勾選一些權(quán)限塘装。
生成完后,你需要拷貝下來影所,只有這時(shí)候他才顯示蹦肴,下載進(jìn)來為了安全他就不會(huì)顯示了,如果忘了只能重新生成一個(gè)了猴娩,拷貝完以后我們需要到Travis CI網(wǎng)站配置下
在Travis CI配置
配置界面還是在項(xiàng)目的setting里面阴幌,如下圖:
至于為什么我們要在這里配置,我想大家肯定應(yīng)該明白了卷中,寫在程序里不安全矛双,配置到這里相當(dāng)于一個(gè)環(huán)境變量,我們?cè)跇?gòu)建的時(shí)候就可以引用他蟆豫。
到這里我已經(jīng)配置了要構(gòu)建的倉庫和要訪問的Token议忽,但是問題來了,他知道怎么構(gòu)建十减,怎么生成靜態(tài)文件嗎徙瓶,怎么push的github pages,又push到那個(gè)倉庫嗎嫉称,所以這里我們還需要在源代碼的倉庫里創(chuàng)建一個(gè).travis.yml配置文件侦镇,放到源代碼的根目錄,如下圖:
文件內(nèi)容:
language: node_js
node_js: stable
# S: Build Lifecycle
install:
- npm install
#before_script:
# - npm install -g gulp
script:
- hexo g
after_script:
- cd ./public
- git init
- git config user.name "your nickname"
- git config user.email "your email"
- git add .
- git commit -m "Update docs"
- git push --force --quiet "https://${GH_TOKEN}@${GH_REF}" master:master
# E: Build LifeCycle
branches:
only:
- blog-source
env:
global:
- GH_REF: github.com/atecher/atecher.github.io.git
記得配置一下你的昵稱织阅、郵箱和你的git地址(GH_REF)壳繁。
到這一步,我們可以寫一篇文章,添加到你的博客的_posts目錄下闹炉,然后commit并push到你的Github上蒿赢。
如果不出意外,我們可以就可以在Travis CI網(wǎng)站看到他已經(jīng)在構(gòu)建了渣触,如下圖:
構(gòu)建完成后羡棵,我們?nèi)log上就能看到這篇文章了。
歡迎訪問我的博客:http://atecher.com/嗅钻,有更多精彩文章皂冰!