Temp fix decade-long Sphinx bug breaking our CSS during partial rebuilds #2496
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
TL;DR: Ship 3.0 by letting you edit CSS without
./make.py clean
😱!How do I use this & When?
Does CSS not copy right on your local machine? Then:
cd $ARCADE_DIR
touch .ENABLE_DEVMACHINE_SPHINX_STATIC_FIX
./make.py html
or./make.py serve
as usualWhy do this?
TL;DR: Debugging CSS is already hard enough
_static
has been making CSS harder by being broken since at least 2015./make.py html
./make.py serve
(it's based onsphinx-autobuild
, see this comment for more).Technical Details
./make.py clean
(slow, hurts)Builder
sphinx-doc/sphinx#13236 on Jan 15th, 2025Does this affect CI runs / readthedocs / code quality scans?
No.