Skip to content

Commit bd6d617

Browse files
DeusDataDeusData
andauthored
ci: deploy Pages via Actions, scoped to docs changes (#425)
The legacy "Deploy from a branch" Pages build ran Jekyll on every push to main and failed on the planning docs under /docs — Jekyll's Liquid parser hit `Unknown tag 'data'` in EVALUATION_PLAN.md, so the website build went red after nearly every commit. /docs is a hand-written static site (index.html + robots/sitemap/llms.txt), so it never needed Jekyll. Deploy it with a GitHub Actions workflow that uploads /docs as-is and only triggers on docs/** changes, and add a .nojekyll guard. Switch the Pages source to "GitHub Actions" for this to take over from the legacy build. Co-authored-by: DeusData <joerge@datadice.io>
1 parent 791b768 commit bd6d617

2 files changed

Lines changed: 44 additions & 0 deletions

File tree

.github/workflows/pages.yml

Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
# Deploy the static site in /docs to GitHub Pages.
2+
#
3+
# Replaces the legacy "Deploy from a branch" (Jekyll) build, which ran on
4+
# EVERY push to main and failed because Jekyll's Liquid parser choked on the
5+
# planning docs under /docs (e.g. `Unknown tag 'data'` in EVALUATION_PLAN.md).
6+
# /docs is a hand-written static site (index.html + robots/sitemap/llms.txt),
7+
# so we upload it as-is — no Jekyll — and only run when the site changes.
8+
#
9+
# Requires the repo Pages source to be set to "GitHub Actions"
10+
# (Settings → Pages → Build and deployment → Source: GitHub Actions).
11+
name: Deploy Pages
12+
13+
on:
14+
push:
15+
branches: [main]
16+
paths:
17+
- 'docs/**'
18+
- '.github/workflows/pages.yml'
19+
workflow_dispatch:
20+
21+
permissions:
22+
contents: read
23+
pages: write
24+
id-token: write
25+
26+
# One deployment at a time; never cancel an in-progress publish.
27+
concurrency:
28+
group: pages
29+
cancel-in-progress: false
30+
31+
jobs:
32+
deploy:
33+
runs-on: ubuntu-latest
34+
environment:
35+
name: github-pages
36+
url: ${{ steps.deployment.outputs.page_url }}
37+
steps:
38+
- uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
39+
- uses: actions/configure-pages@45bfe0192ca1faeb007ade9deae92b16b8254a0d # v6.0.0
40+
- uses: actions/upload-pages-artifact@fc324d3547104276b827a68afc52ff2a11cc49c9 # v5.0.0
41+
with:
42+
path: ./docs
43+
- id: deployment
44+
uses: actions/deploy-pages@cd2ce8fcbc39b97be8ca5fce6e763baed58fa128 # v5.0.0

docs/.nojekyll

Whitespace-only changes.

0 commit comments

Comments
 (0)