Hexo GitLab Pages

在本教程中，我們將會使用 GitLab CI 將 Hexo 博客部署到 GitLab Pages 上。

1. 新建一個 repository。如果你希望你的站點能通過 <你的 GitLab 用戶名>.gitlab.io 域名訪問，你的 repository 應該直接命名為 <你的 GitLab 用戶名>.gitlab.io。
2. 將你的 Hexo 站點文件夾推送到 repository 中。默認情況下不應該 public 目錄將不會被推送到 repository 中，你應該檢查 .gitignore 文件中是否包含 public 一行，如果沒有請加上。
3. 在你的站點文件夾中新建 .gitlab-ci.yml 文件：

image: node:10-alpine # use nodejs v10 LTS
cache:
  paths:
    - node_modules/
?
before_script:
  - npm install hexo-cli -g
  - npm install
?
pages:
  script:
    - hexo generate
  artifacts:
    paths:
      - public
  only:
    - master

1. GitLab CI 應該會自動開始運行，構建成功以后你應該可以在 https://<你的 GitLab 用戶名>.gitlab.io 查看你的網站。
2. (可選) 如果你需要查看生成的文件，可以在 job artifact中找到。

在 GitLab.com 上，GitLab CI 是默認啟用的。如果你使用的是自托管的 GitLab，你可能需要在 Settings -> CI / CD -> Shared Runners 啟用 GitLab CI。

Project page

如果你更希望你的站點部署在 <你的 GitLab 用戶名>.gitlab.io 的子目錄中，你的 repository 需要直接命名為子目錄的名字，這樣你的站點可以通過 https://<你的 GitLab 用戶名>.gitlab.io/<repository 的名字> 訪問。你需要檢查你的 Hexo 配置文件，將 url 的值修改為 https://<你的 GitLab 用戶名>.gitlab.io/<repository 的名字>、將 root 的值修改為 /<repository 的名字>/

Useful links

• GitLab Pages 相關文檔
• GitLab CI 相關文檔
• 在百度上搜索 “Hexo GitLab”