Re: Bug#932957: New theme for docs in reStructuredText (was: Re: Bug#932957: #932957 Please migrate Release Notes to reStructuredText)

Holger Wansing <[email protected]> wrote (Fri, 24 Nov 2023 22:49:47 +0100):
> I used the alabaster theme, which is the default theme in Sphinx, and 
> set some configuration options in conf.py, to adapt some details. That's all.
> 
> So no need to create a new theme IMO.
> 
> Just set the appropriate options in the manual, and build it.

I have switched trixie's release-notes to this new theme, and the result 
is now visible on www.debian.org/releases/trixie/release-notes.

I noticed, that the links to the previous and next chapter at the top
and the bottom of the pages are missing.

Some research showed, that the reason for this is the sphinx version on
www-master, which is a bullseye system.
Starting with the sphinx version in bookworm, those links are supported.
So this will start working, when wolkenstein will get updated to bookworm.

Moreover, I changed the Debian logo to include the document name (here:
"Release-Notes"), to have that information available on every page of the
release-notes (at the top).


Holger