Skip to content

Build: do not use custom builder when DISABLE_SPHINX_MANIPULATION #11499

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.

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
merged 1 commit into from
Jul 25, 2024

Conversation

humitos
Copy link
Member

@humitos humitos commented Jul 24, 2024

We are installing readthedocssinglehtmllocalmedia Sphinx builder via our readthedocs-sphinx-ext extension.

I checked that code and this builder doesn't do anything super special. It only adds a CSS file that it's related with the flyout, which it's not useful anymore:
https://github.com/readthedocs/readthedocs-sphinx-ext/blob/13edf78bab374f51e314e4994c319fadbab806f2/readthedocs_ext/readthedocs.py#L81-L83

This commit runs singlehtml Sphinx builder (the default from Sphinx) when the DISABLE_SPHINX_MANIPULATION feature flag is enabled. I tested this locally using all-formats branch from test-builds and I got the same results (except from the flyout, which is not injected anymore since there is no context injected in the new behavior)

We are installing `readthedocssinglehtmllocalmedia` Sphinx builder via our
`readthedocs-sphinx-ext` extension.

I checked that code and this builder doesn't do anything super special. It only
adds a CSS file that it's related with the flyout, which it's not useful
anymore:
https://github.com/readthedocs/readthedocs-sphinx-ext/blob/13edf78bab374f51e314e4994c319fadbab806f2/readthedocs_ext/readthedocs.py#L81-L83

This commit runs `singlehtml` Sphinx builder (the default from Sphinx) when the
`DISABLE_SPHINX_MANIPULATION` feature flag is enabled. I tested this locally
using `all-formats` branch from `test-builds` and I got the same results (except
from the flyout, which is not injected anymore since there is no context
injected in the new behavior)
@humitos humitos requested a review from ericholscher July 24, 2024 17:42
@humitos humitos requested a review from a team as a code owner July 24, 2024 17:42
@humitos humitos merged commit d281701 into main Jul 25, 2024
8 checks passed
@humitos humitos deleted the humitos/sphinx-manipulation-builder branch July 25, 2024 08:53
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