ci(pages): 文档站切换为 Actions workflow 部署

legacy 分支构建模式在服务端连续卡死(build 持续 building 状态 2 小时+,
多次重触发无效,GitHub 状态页无事件),且过程黑盒无日志可查。
切换为官方标准的 Actions 部署(jekyll-build-pages + deploy-pages):
渲染器相同、输出一致,构建失败时有真实日志,concurrency 保证
只保留最新部署。仅在 docs/ 变更时触发。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
晴天
2026-07-06 00:29:43 -07:00
parent fc4313d613
commit b36a85e230

50
.github/workflows/pages.yml vendored Normal file
View File

@@ -0,0 +1,50 @@
# GitHub Pages 部署Actions 模式)
# 替代 legacy 分支构建:构建过程可见、失败有日志,避免服务端队列黑盒卡死。
# 输出与 legacy 完全一致(同为官方 Jekyll 构建器渲染 docs/)。
name: Pages
on:
push:
branches: [main]
paths:
- "docs/**"
- ".github/workflows/pages.yml"
workflow_dispatch:
permissions:
contents: read
pages: write
id-token: write
# 同一时间只保留最新一次部署,取消进行中的旧部署
concurrency:
group: pages
cancel-in-progress: true
jobs:
build:
runs-on: ubuntu-latest
steps:
- name: 签出代码
uses: actions/checkout@v4
- name: 配置 Pages
id: pages
uses: actions/configure-pages@v5
- name: Jekyll 构建
uses: actions/jekyll-build-pages@v1
with:
source: ./docs
destination: ./_site
- name: 上传站点产物
uses: actions/upload-pages-artifact@v3
deploy:
environment:
name: github-pages
url: ${{ steps.deployment.outputs.page_url }}
runs-on: ubuntu-latest
needs: build
steps:
- name: 部署到 GitHub Pages
id: deployment
uses: actions/deploy-pages@v4