Hexo + GitHub Actions 自動部署

發表於 更新於 分類於 本文字數： 1.1k 閱讀時長 ≈ 2 分鍾

突然間想寫吓 Blog，咁不如自己搭個出來啦。

第一篇就寫這呢個 Blog 嘅搭建過程，同埋途中中過嘅伏。

對上一次已經係用摺咗嘅 Xanga，而家有 GitHub Page，可以自己搞個嚟玩吓。最後用 Hexo 嘅原因好簡單 ── 睇中咗 Next 呢個 theme。

安裝過程

安裝過程唔詳細寫，自己 Google 都搵到大把教學，所以我簡單寫 D step 出嚟就算。

安裝 Git

上 Git 官網 download 後安裝，安裝後打 git -- version 檢查安裝成唔成功

安裝 Node.js

上 Node.js 官網 download 後安裝，安裝後打 node -v npm -v 檢查安裝成唔成功

安裝 Hexo

打 npm install -g hexo-cli 安裝，之後打 hexo init 令 Hexo 起好所有文件

之後可以打 hexo s，再去 localhost:4000 就可以見到個 Blog

安裝 Hexo 主題

2023 更新:

最近 upgrade Hexo 嘅時候，改用官方建議嘅 Alternate Theme Config 方法。唔洗再 clone 成個 Hexo NexT 主題嘅 repo 落嚟。

先用 npm 安裝主題

1
npm install hexo-theme-next --save

之後將 _config copy 落 Hexo folder

1
cp node_modules/hexo-theme-next/_config.yml _config.next.yml

之後打開 /_config.yml 改 setting，將 theme 改做 next，deploy set 做 git

1
2
3
4
5
6
theme: next

deploy:
  type: git
  repo: git@github.com:kennyfong19931/kennyfong19931.github.io.git
  branch: master

theme setting 可以打開 /_config.next.yml 改

GitHub Actions + GitHub Pages

我今次係用 2 個 repo 嘅 setting，hexo source code 放 private repo，GitHub Pages 用 <username>.github.io repo。

GitHub actions 係 GitHub 出嘅 CI/CD 工具，只需要一個 workflow 文件就做到自動 Build + Test + Deploy，2019年11月推出左正式版，所有人都可以免費係用。GitHub Marketplace 上有其他用家開發嘅 Action。

我今次用嘅係 peaceiris/actions-gh-pages，跟入面作者提供嘅 example 做就得。只要 repo .github/workflows 入面有 YAML 格式檔案，GitHub Actions 就會自動行。