Skip to content

DOC fix pages deploy#1466

Merged
romanlutz merged 3 commits intoAzure:mainfrom
romanlutz:fix-pages-deploy
Mar 13, 2026
Merged

DOC fix pages deploy#1466
romanlutz merged 3 commits intoAzure:mainfrom
romanlutz:fix-pages-deploy

Conversation

@romanlutz
Copy link
Contributor

No description provided.

romanlutz and others added 3 commits March 13, 2026 16:05
JB2's default 'jupyter-book build' produces a SPA (JSON content +
client-side rendering) that requires a web server. GitHub Pages
serves static files and gets a 404 because there's no index.html.

Fix by adding --html flag which generates static HTML via server-side
rendering, and update the artifact upload path from _build/site to
_build/html.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Two issues causing the 404 after JB2 upgrade:

1. JB2's default build produces a SPA (JSON + client-side JS) that
   needs a web server. GitHub Pages serves static files -> no index.html.
   Fix: add --html flag to jupyter-book build.

2. Site is at azure.github.io/PyRIT/ (subpath), but assets were
   referenced from root (/build/...). Fix: set BASE_URL env var in
   the workflow per MyST deployment docs.

- Makefile: jupyter-book build --all -> --all --html
- docs.yml: artifact path _build/site -> _build/html
- docs.yml: add BASE_URL env var using repository name

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@romanlutz romanlutz merged commit d4f1d0a into Azure:main Mar 13, 2026
29 checks passed
@romanlutz romanlutz deleted the fix-pages-deploy branch March 13, 2026 23:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants