Re: [Qemu-devel] [PATCH 05/11] docs/conf.py: Configure the 'alabaster' theme

[Peter Maydell]

On Fri, 1 Feb 2019 at 16:43, Alex Bennée <address@hidden> wrote:
>
>
> Peter Maydell <address@hidden> writes:
>
> > Add the 'navigation' bar to the sidebar, which for some
> > reason is not enabled by default. Remove 'relations', which
> > is effectively disabled anyway and isn't useful for us.
>
> I'm not sure what the title means... is the theme a reference to a
> layout? I thought themes were colours and other such visual frippery
> rather than actual content layout. But what do I know as a mere code
> monkey...

Just noticed I never followed up to this. Sphinx themes
allow a bit more customisation than just "colours and fonts":
they can also do layout things like changing up what sorts of
sidebar information is shown, or indeed whether there's any
kind of sidebar at all. Specific themes might expose some
theme-specific config options which allow tweaking of how
they appear.

http://www.sphinx-doc.org/en/stable/theming.html
has a few screenshots and gives more of an idea of what
sort of tweaks the theming system allows.

thanks
-- PMM