Skip to content

[codex] Fix GitHub Pages notebook rendering#1

Closed
B67687 wants to merge 2 commits intomainfrom
codex/pages-notebook-html
Closed

[codex] Fix GitHub Pages notebook rendering#1
B67687 wants to merge 2 commits intomainfrom
codex/pages-notebook-html

Conversation

@B67687
Copy link
Copy Markdown
Owner

@B67687 B67687 commented Apr 9, 2026

What changed

This PR adds a GitHub Pages build pipeline that renders every Jupyter notebook into HTML before deployment.

Why it changed

The current GitHub Pages site renders README.md for the homepage, but all notebook links still point to raw .ipynb files. On Pages those files are served as notebook JSON, which makes the browser view look broken instead of showing a readable notebook page.

User impact

Notebook links on the published site will open rendered HTML pages instead of raw notebook JSON. The homepage keeps the existing README-driven structure, but its links are rewritten for the generated site.

Root cause

GitHub Pages does not automatically render linked .ipynb files from a repository site. The site needed a build step that converts notebooks to static HTML and deploys that output.

Validation

I could syntax-check the build script locally, but this desktop environment had local permission and nbconvert template issues that prevented a full local Pages build. The PR includes a clean GitHub Actions workflow so the build runs on a fresh GitHub runner instead.

Copy link
Copy Markdown
Owner Author

B67687 commented Apr 9, 2026

Superseded by a replacement PR on branch pages/notebook-html-rendering: #2. I kept the same code changes there so the branch name is more descriptive.

@B67687 B67687 closed this Apr 9, 2026
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.

1 participant