Skip to content

Conversation

@MaxGhenis
Copy link
Contributor

Summary

Fixes the GitHub Pages documentation site which was showing raw HTML instead of rendered pages.

Problem

The documentation at https://policyengine.github.io/policyengine-us-data/ was not rendering properly because MyST was generating absolute paths (like /build/) that don't work when served from a GitHub Pages subdirectory.

Solution

Set the BASE_URL environment variable to /policyengine-us-data when building documentation for deployment. MyST uses this to generate correct relative paths.

Test

The documentation will render correctly at https://policyengine.github.io/policyengine-us-data/ after this fix is deployed.

Set BASE_URL environment variable when building documentation for deployment. MyST needs this to generate correct paths when serving from GitHub Pages subdirectory.
@MaxGhenis MaxGhenis merged commit 1ef3c27 into main Jul 30, 2025
6 checks passed
@nikhilwoodruff nikhilwoodruff deleted the fix-gh-pages-rendering branch August 4, 2025 12:49
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