Skip to content

Auto-enable GitHub Pages on first deploy #2

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
bassim-matar merged 1 commit into from
Jul 10, 2026
Merged

Auto-enable GitHub Pages on first deploy #2

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
5 changes: 5 additions & 0 deletions .github/workflows/build.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -83,5 +83,10 @@ jobs:
name: github-pages
url: ${{ steps.deployment.outputs.page_url }}
steps:
# Enables GitHub Pages (source: GitHub Actions) on first run,
# so no manual repository setting is needed.
- uses: actions/configure-pages@v5
with:
enablement: true
- id: deployment
uses: actions/deploy-pages@v4
5 changes: 2 additions & 3 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,9 +17,8 @@ This template publishes a [datannur](https://datannur.com) catalog on GitHub Pag
## Quick start

1. Click **Use this template** → **Create a new repository** (public).
2. In your new repository, open **Settings**, pick **Pages** in the left sidebar, and under *Build and deployment* switch **Source** from *Deploy from a branch* to **GitHub Actions**.
3. Edit a file or upload your own data (see below). Each commit triggers a build.
4. After ~2 minutes, your catalog is live at `https://<account>.github.io/<repository>/`.
2. That's it — the first build starts on its own, enables GitHub Pages and publishes your catalog. After ~2 minutes it is live at `https://<account>.github.io/<repository>/` (link in the **Actions** tab, or in **Settings → Pages**).
3. Edit a file or upload your own data (see below). Each commit rebuilds and republishes the catalog.

> **Forked instead of using the template?** GitHub disables workflows on forks by default: open the **Actions** tab and click **I understand my workflows, go ahead and enable them** first.

Expand Down
Loading