Re: Bug#1053549: Create a Debian theme for documentation based in Sphinx (reStructuredText)

[Holger Wansing <hwansing@mailbox.org>]

Hi,

Laura Arjona Reina <larjona@debian.org> wrote (Fri, 6 Oct 2023 09:35:09 +0200):
> Several documentation manuals are being generated now using 
> ReStructuredText and Sphinx, and it would be nice that a Debian theme in 
> Sphinx is created and used to match our docs appearance with the Debian 
> website colours etc.

Thanks to Stéphane Blondon, we have a nice Debian theme for Sphinx now, and
I managed to get it to the website in the end so far, currently visible at
debian-policy:
https://www.debian.org/doc/debian-policy/index.html

I had to deal with some missing javascript files as well, to make the 
sidebar appear/disappear on small screens like smartphones, but that works
now.

The only thing which is not working currently, is the search functionality,
but since that's not theme-specific I guess (please correct me, if I'm 
wrong), I close this bug.

Javascript leaves some open issues, but for those I will follow-up on some 
existing javascript bugs, we already have for the website/manuals.


Holger


-- 
Holger Wansing <hwansing@mailbox.org>
PGP-Fingerprint: 496A C6E8 1442 4B34 8508  3529 59F1 87CA 156E B076