Repository navigation
Trim the Sphinx configuration to the settings in use - #119
Merged
stefankoegl merged 1 commit intoNov 11, 2026
Merged
Conversation
doc/conf.py was the 2013 sphinx-quickstart template, mostly commented-out defaults. Keep only the settings that differ from Sphinx's defaults, and: - use the "classic" theme name instead of its legacy alias "default" (the generated HTML is identical apart from the alias stylesheet) - drop templates_path and html_static_path, which pointed at an empty or missing directory, along with doc/_static/.empty - define the author once and reuse it for the LaTeX, man and Texinfo outputs Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01PewzpjhRBV84QNbKy9H564
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
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.
Stacked on #114. Once that merges, retarget this to
master.doc/conf.pywas still the 2013sphinx-quickstarttemplate, about 245 lines of mostly commented-out defaults. This keeps only the settings that differ from Sphinx's defaults:html_theme = 'default'becomes'classic'.defaultis a legacy alias forclassic.templates_pathandhtml_static_pathare removed. They pointed at a missing directory and an empty one, and the emptydoc/_static/.emptyis deleted.Verification: I built the HTML before and after the change and diffed the output. The only difference is the
_static/default.cssalias stylesheet, which is no longer generated. The-Wbuilds for html, man, texinfo and latex all pass.Generated by Claude Code