On Wed, 5 Jul 2023 09:26:32 -0700 (PDT), Phillip Downen wrote:
> I'm trying to change from sphinx_rtd_theme to the alabaster theme and
> the html output does not look right...I change the theme as follows in
> #html_theme = 'sphinx_rtd_theme'
> html_theme = 'alabaster'
On every project I work, the change of theme (especially between alabaster
and rtd) does not impact significantly on the output, except, well, for the
layout :-) I never experienced errors like the few glitches that you
mention. If you posted the log of make clean html, perhaps it could give
you some more insights on what's failing. When switching theme, you should:
* change html_theme option (which you did)
* remove or change html_theme_options according to the new theme
* remember that any custom CSS and template you added will probably be
useless, as different themes use different templates and generate different
* review all html_* options, because some of them may be unsupported
(although this has usually no influence on the build, these are usually
> Also, I don't have any layout.html file in \_templates. Not sure if a
> layout.html is needed or not.
If you did no customisation, you don't need it.