Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions .github/workflows/pages.yml
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,10 @@ jobs:
uses: actions/checkout@v4
- name: Configure Pages
uses: actions/configure-pages@v5
with:
# Auto-enable Pages (build type: GitHub Actions) if it isn't already,
# so no manual repo-settings step is required.
enablement: true
- name: Build with Jekyll
uses: actions/jekyll-build-pages@v1
with:
Expand Down
14 changes: 8 additions & 6 deletions pages/DEPLOY.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,16 +13,18 @@ publish it; pick one.
## Approach 1 — GitHub Actions (recommended)

The repo ships `.github/workflows/pages.yml`, which builds `pages/` with Jekyll
and deploys it on every push to `master`.
and deploys it on every push to `master`. The `configure-pages` step uses
`enablement: true`, so it **turns Pages on automatically** (build type: GitHub
Actions) — no manual settings step needed.

1. Push the `pages/` folder and the workflow to `master`.
2. In the repo: **Settings → Pages → Build and deployment → Source: GitHub
Actions**.
3. The workflow runs (watch **Actions**); the site goes live at
`https://<user>.github.io/<repo>/`.
2. Watch the **Actions** tab; on success the site goes live at
`https://<user>.github.io/<repo>/` (and the URL is shown on the `deploy`
job).

You can also trigger it manually from the **Actions** tab
(*workflow_dispatch*).
(*workflow_dispatch*). If auto-enable is blocked by org policy, enable it once
under **Settings → Pages → Source: GitHub Actions** and re-run.

Why this one: it publishes an arbitrary subfolder (`pages/`) without moving
files, and it's the modern GitHub-recommended flow.
Expand Down
Loading