GitLab Pages

  1. 建立一個名為 username.gitlab.io 的新儲存庫,其中 username 是您在 GitLab 上的使用者名稱。如果您已經上傳到其他儲存庫,請改為重新命名該儲存庫。
  2. 透過 設定 > CI/CD > 執行器 > 啟用此專案的共用執行器 來啟用共用執行器。
  3. 將您的 Hexo 資料夾中的檔案推送到儲存庫。預設情況下,public/ 資料夾不會(且不應該)上傳,請確保 .gitignore 檔案包含 public/ 行。資料夾結構應該大致與這個儲存庫類似。
  4. 使用 node --version 檢查您在本機上使用的 Node.js 版本。記下主要版本(例如,v16.y.z)。
  5. .gitlab-ci.yml 檔案新增到儲存庫的根資料夾(與 _config.yml 和 package.json 並列),內容如下(將 16 替換為您在上一步中記下的 Node.js 主要版本)
image: node:16-alpine
cache:
paths:
- node_modules/

before_script:
- npm install hexo-cli -g
- npm install

pages:
script:
- npm run build
artifacts:
paths:
- public
rules:
- if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
  1. 一旦 GitLab CI 完成部署作業,username.gitlab.io 應該會啟動並執行。
  2. (選用)如果您想檢查產生的網站資產(html、css、js 等),可以在作業成品中找到它們。

專案頁面

如果您希望在 GitLab 上擁有專案頁面

  1. 前往 設定 > 一般 > 進階 > 變更路徑。將值變更為一個名稱,以便網站可在 username.gitlab.io/repository 上使用。它可以是任何名稱,例如 bloghexo
  2. 編輯 _config.yml,將 url: 值變更為 https://username.gitlab.io/repository
  3. 提交並推送。

實用連結