Re: [PATCH] RFC: sphinx: adopt kernel readthedoc theme

[Marc-André Lureau]

Hi,

On Thu, Nov 5, 2020 at 8:03 PM <marcandre.lureau@redhat.com> wrote:
>
> From: Marc-André Lureau <marcandre.lureau@redhat.com>
>
> The default "alabaster" sphinx theme has a couple shortcomings:
> - the navbar moves along the page
> - the search bar is not always at the same place
> - it lacks some contrast and colours
>
> The "rtd" theme from readthedocs.org is a popular third party theme used
> notably by the kernel, with a custom style sheet. I like it better,
> perhaps others do too. It also has features that may come handy, such as
> "Edit on Gitlab".
>
> Tweak the nav header background to match qemu.org style, use the
> QEMU logo, and favicon.
>
> The html_theme_options['description'] workaround doesn't seem necessary.
>
> Signed-off-by: Marc-André Lureau <marcandre.lureau@redhat.com>
> ---
>  docs/conf.py                           |  36 +++----
>  docs/devel/conf.py                     |   4 -
>  docs/interop/conf.py                   |   4 -
>  docs/specs/conf.py                     |   5 -
>  docs/sphinx-static/theme_overrides.css | 137 +++++++++++++++++++++++++
>  docs/system/conf.py                    |   4 -
>  docs/tools/conf.py                     |   5 -
>  docs/user/conf.py                      |   4 -
>  8 files changed, 155 insertions(+), 44 deletions(-)
>  create mode 100644 docs/sphinx-static/theme_overrides.css
>

Am I the only one finding the default sphinx theme inferior to rtd ?

thanks