However, currently, these setup helper functions will not run if the theme is not set to Furo. (That's a good default behavior because it avoids Furo doing undesired things when you have Furo installed but aren't actually using it.)
So, this adds the argument validate_furo: bool = True to both _html_page_context and _builder_inited. That allows plugins to use functools.partial to set the argument to False, as done in https://github.com/pradyunsg/furo/pull/648.
The default behavior is unaffected because the default is set to True.
To inherit Furo, the new Sphinx theme needs to call the setup code from
furo/__init__.py
'ssetup
. See https://github.com/pradyunsg/furo/pull/648 for an example.However, currently, these setup helper functions will not run if the theme is not set to Furo. (That's a good default behavior because it avoids Furo doing undesired things when you have Furo installed but aren't actually using it.)
So, this adds the argument
validate_furo: bool = True
to both_html_page_context
and_builder_inited
. That allows plugins to usefunctools.partial
to set the argument toFalse
, as done in https://github.com/pradyunsg/furo/pull/648.The default behavior is unaffected because the default is set to
True
.