Skip to content

Commit 4eede5c

Browse files
committed
ci(pages): replace legacy branch Pages with Actions workflow
Legacy branch-based Pages (source = main /docs with Jekyll) was stuck: push f63f468 -> 056c71f never triggered a rebuild (last successful build 2026-05-24), and a manual POST .../pages/builds stalled at "building" for 3+ minutes (normal: 30-40s). Switch to the modern Pages workflow: - upload docs/ as artifact via actions/upload-pages-artifact@v3 - deploy via actions/deploy-pages@v4 - triggers on push to main when docs/** or this workflow change - concurrency group "pages" with cancel-in-progress to keep latest Pages source already PATCHed to build_type=workflow via gh api.
1 parent 056c71f commit 4eede5c

1 file changed

Lines changed: 48 additions & 0 deletions

File tree

.github/workflows/pages.yml

Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
name: Deploy GitHub Pages
2+
3+
# Replaces the legacy branch-based Pages build (was: source = main /docs).
4+
# This workflow uploads docs/ as a Pages artifact and deploys via the
5+
# official actions/deploy-pages action. Faster and more reliable than the
6+
# legacy Jekyll path, especially when the docs/ tree contains many large
7+
# pre-rendered HTML files.
8+
9+
on:
10+
push:
11+
branches: [main]
12+
paths:
13+
- "docs/**"
14+
- ".github/workflows/pages.yml"
15+
workflow_dispatch:
16+
17+
# Allow GITHUB_TOKEN to deploy to Pages.
18+
permissions:
19+
contents: read
20+
pages: write
21+
id-token: write
22+
23+
# Only one Pages deployment at a time; cancel in-progress runs on new push.
24+
concurrency:
25+
group: pages
26+
cancel-in-progress: true
27+
28+
jobs:
29+
deploy:
30+
runs-on: ubuntu-latest
31+
environment:
32+
name: github-pages
33+
url: ${{ steps.deployment.outputs.page_url }}
34+
steps:
35+
- name: Checkout
36+
uses: actions/checkout@v4
37+
38+
- name: Setup Pages
39+
uses: actions/configure-pages@v5
40+
41+
- name: Upload docs/ as Pages artifact
42+
uses: actions/upload-pages-artifact@v3
43+
with:
44+
path: docs
45+
46+
- name: Deploy to GitHub Pages
47+
id: deployment
48+
uses: actions/deploy-pages@v4

0 commit comments

Comments
 (0)