本文將使用 GitHub Actions 部屬至 GitHub Pages,此方法適用於公開或私人儲存庫。若你不希望將整個資料夾推上 GitHub,請參閱 一鍵部屬。
- 建立名為
<你的 GitHub 使用者名稱>.github.io
的儲存庫,username 是你在 GitHub 上的使用者名稱,若之前已將 Hexo 上傳至其他儲存庫,將該儲存庫重命名即可。 - 將 Hexo 檔案 push 到儲存庫的預設分支,預設分支通常名為 main,舊一點的儲存庫可能名為 master。
將
main
分支 push 到 GitHub:$ git push -u origin main
- 預設情況下
public/
不會被上傳(也不該被上傳),確認.gitignore
檔案中包含一行public/
。整體資料夾結構應會與範例儲存庫極為相似。
- 預設情況下
- 使用
node --version
指令檢查你電腦上的 Node.js 版本,並記下該版本 (例如:v20.y.z
) - 在儲存庫中前往
Settings > Pages > Source
,並將Source
改為GitHub Actions
。 - 在儲存庫中建立
.github/workflows/pages.yml
,並填入以下內容 (將20
替換為上個步驟中記下的版本):
name: Pages |
- 當部屬作業完成後,前往
https://<你的 GitHub 使用者名稱>.github.io
檢視網站。
CNAME若你使用
CNAME
自訂域名,你需要在source/
資料夾中新增CNAME
檔案。更多資訊
專案頁面
如果你希望網站部署在 <你的 GitHub 使用者名稱>.github.io
的子目錄中:
- 建立名為
<repository 的名字>
的儲存庫,這樣你的部落格網址為<你的 GitHub 使用者名稱>.github.io/<repository 的名字>
,repository 的名字可以任意,例如 blog 或 hexo。 - 編輯你的
_config.yml
,將url:
更改為<你的 GitHub 使用者名稱>.github.io/<repository 的名字>
。 - 在儲存庫中前往
Settings > Pages > Source
,並將Source
改為GitHub Actions
。 - Commit 並 push 到預設分支上。
- 部署完成後,前往
https://<你的 GitHub 使用者名稱>.github.io/<repository 的名字>
檢視網站。
一鍵部屬
以下教學改編自 一鍵部署 .
- 安裝 hexo-deployer-git.
- 清空
_config.yml
的現有資料,並新增以下組態:
deploy: |
- 執行
hexo clean && hexo deploy
。 - 瀏覽
<GitHub 用戶名>.github.io
檢查你的網站能否運作。
Windows 用戶Awesome Hexo 中收錄了更多有關在 GitHub Pages 上部署 Hexo ,你也可透過搜尋引擎了解更多。
歡迎更多有誌之士前來改善 Hexo 文檔,不勝感激。