[New-bugs-announce] [issue24832] Issue building docs with newer sphix (default theme -> classic)

[R. David Murray]

New submission from R. David Murray:

After doing a make clean in Doc, the built documents no longer rendered correctly.  I tracked this down to the Sphinx warning I'd been ignoring for a while:

WARNING: 'default' html theme has been renamed to 'classic'. Please change your html_theme setting either to the new 'alabaster' default theme, or to 'classic' to keep using the old default.

Now, this seems problematic, because we don't know which version of Sphinx is going to be used to build the docs, so it doesn't seen correct to just change "inherit = default" to "inherit = classic" in tools/pydoctheme.conf.

Any sphinx experts know what the correct solution is here?  Do we change it and thus (IIUC) require 1.3.1 as the minimum Sphinx version?

----------
assignee: docs at python
components: Documentation
messages: 248285
nosy: docs at python, r.david.murray
priority: normal
severity: normal
status: open
title: Issue building docs with newer sphix (default theme -> classic)

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue24832>
_______________________________________