Fix GitHub Pages 502: add .nojekyll and root index.html#110
Fix GitHub Pages 502: add .nojekyll and root index.html#110
Conversation
Co-authored-by: blackboxprogramming <118287761+blackboxprogramming@users.noreply.github.com>
There was a problem hiding this comment.
Pull request overview
This PR fixes a GitHub Pages deployment issue where the actions/deploy-pages action was receiving a 502 error due to Jekyll attempting to process a large 749KB README.md file with no static entry point. The solution disables Jekyll processing entirely and provides a proper landing page.
Changes:
- Added
.nojekyllfile to disable Jekyll processing and enable pure static file serving - Added
index.htmlas a root entry point with navigation to all documentation sections
Reviewed changes
Copilot reviewed 1 out of 2 changed files in this pull request and generated no comments.
| File | Description |
|---|---|
| .nojekyll | Empty file that instructs GitHub Pages to skip Jekyll processing, resolving the 502 timeout error |
| index.html | Clean, semantic HTML landing page with navigation links to all content sections (paper, equations, proofs, figures, etc.) |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
|
You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard. |
actions/deploy-pageswas receiving GitHub's HTML 502 error page instead of a JSON API response, caused by the Pages pipeline attempting Jekyll processing on a 749KBREADME.mdwith no static entry point to fall back to.Changes
.nojekyll— disables Jekyll entirely; forces static file serving, eliminating the processing timeout that triggered the 502index.html— adds a root entry point with links to all content sections (paper, equations, proofs, figures, etc.), removing the ambiguity of a no-index static siteOriginal prompt
💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.