0%

How to deploy github pages with hexo

緣起

身為一位自以為專業的技客,自然要有一個自己的 github 帳號
然後有了帳號以後下一步至少要有一個 github pages 的 blog
於是花了點時間摸了一下如何利用 hexo 這個套件來部屬,未免忘記在這邊記錄一下。

前置作業

先去你的 github 開一個新的 repo
名稱要是你的 .github.io,其他都預設即可

Update homebrew and install node (and npm)

1
2
$ brew update
$ brew install node

Install hexo by npm

1
$ npm install -g hexo

Initialize a folder by hexo

1
2
3
$ hexo init <folder>
$ cd <folder>
$ npm install

這個時候應該會看到資料夾底下多了一堆東西,其中有一個檔案是 _config.yml

打開它之後拉到最下面在 deploy 的位置改成下面這樣

1
2
3
4
deploy:
type: github
repo: <repo uri> (可使用 ssh or https)
branch: master

Deploy your pages

1
$ hexo deploy

打開你的 http://username.github.io 應該就會看到一切已經佈署完成了

後記

之後要編寫文章可以使用以下指令

1
$ hexo new <title name>

會在 source/_post/ 出現一個檔名為 .md 的檔案,請直接對該檔案進行編修<br>這是 markdown 格式的檔案,撰寫方式可以參考 <a href="http://markdown.tw/" target="_blank" rel="noopener">markdown.tw</a>

更新並且發佈如下

1
$ hexo generate -d