Bug#915583: Bug#1059730: debian-policy: switch to new Debian-conform html theme for Sphinx/reST

[Stéphane Blondon]

> Holger Wansing  wrote (Sun, 31 Dec 2023 10:02:29 +0100):
> They look really good indeed.
> Especially how the menu/sidebar is shown/not shown on small screens
> (smartphones) is fine, that was an open point in my proposal :-)

Thanks you but it's more a good work by readthedoc theme than me. ^^


> BTW: I think it would be good to have the 'Next'/'Previous' buttons
> at the top additionally to those at the bottom.
> The theme supports this via a config option. Simply set
>
> html_theme_options = {
> # To get previous/next buttons at the top and the bottom:
> 'prev_next_buttons_location': 'both'
> }
>
> in conf.py.in.

It's a good idea.
The interface is visible in the screenshot attached to this message.


-- 
Stéphane

Bug#915583: Bug#1059730: debian-policy: switch to new Debian-conform html theme for Sphinx/reST

[Holger Wansing]

[ Hrrr, I sent this to the wrong bug #1059730; so resending to the correct 
one #915583 for completeness ]


Holger Wansing  wrote (Sun, 31 Dec 2023 10:02:29 +0100):
> Hi Sean and Stéphane,
> 
> Am 30. Dezember 2023 23:43:17 MEZ schrieb Sean Whitton 
> :
> >Possibly some of your changes could be applied on top of that?
[...]
> @Stéphane: 
> The URL is 404 now, could you provide the draft again somewhere?
> ()

Thanks, your files are back online.
They look really good indeed. 
Especially how the menu/sidebar is shown/not shown on small screens 
(smartphones) is fine, that was an open point in my proposal :-)

BTW: I think it would be good to have the 'Next'/'Previous' buttons
at the top additionally to those at the bottom.
The theme supports this via a config option. Simply set

html_theme_options = {
# To get previous/next buttons at the top and the bottom:
'prev_next_buttons_location': 'both'
}

in conf.py.in.


Holger



-- 
Holger Wansing 
PGP-Fingerprint: 496A C6E8 1442 4B34 8508  3529 59F1 87CA 156E B076