Hello DSA
Inline with the migration of documentation to restructedText / Sphinx there is the need for one more package to be installed on www-master: A somewhat longstanding topic is the creation of a Debian-style html theme for those documents (currently the style of those docs is not really in-line with the color scheme on debian.org. See [2] for example). Thanks to Stéphane Blondon we have a proposal now (see [1]), which is based on a theme from readthedocs.org. To make that work, we need to have python3-sphinx-rtd-theme installed on www-master (?). Without that package, we have a broken html layout, which can be seen at [3] currently. Please note, that this dependency is not a build-dependency, but also needed during runtime (aka: on every www mirror which serves those Sphinx-based documents we need to have python3-sphinx-rtd-theme installed, to make the new theme work for the website visitor). However, I couldn't find any other stanza for www.debian.org web mirrors than www-master. Are all www mirrors deployed from this stanza, or how is it supposed to work? I'm attaching a patch for the debian.org-www-master.debian.org dependencies including the new dependency, in the hope that it is correct this way. Kind regards, Holger [1] https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=915583#25 [2] https://www.debian.org/doc/manuals/developers-reference/index.en.html [3] https://www.debian.org/doc/debian-policy/ -- Holger Wansing <hwans...@mailbox.org> PGP-Fingerprint: 496A C6E8 1442 4B34 8508 3529 59F1 87CA 156E B076
>From 72c0871fa470eeb30e8d4f3afa7d2b1f6ae17f68 Mon Sep 17 00:00:00 2001 From: Holger Wansing <hwans...@mailbox.org> Date: Sun, 24 Mar 2024 18:59:13 +0100 Subject: [PATCH] Add python3-sphinx-rtd-theme as dependency for www-master, to get a nice Debian-style html theme for our Sphinx-based documents --- debian/changelog | 4 ++++ debian/control | 1 + 2 files changed, 5 insertions(+) diff --git a/debian/changelog b/debian/changelog index ef3d457..ffcc71e 100644 --- a/debian/changelog +++ b/debian/changelog @@ -8,6 +8,10 @@ debian.org (74) UNRELEASED; urgency=medium * Drop debian.org-lintian.debian.org * Drop debian.org-lintian-new.debian.org + [ Holger Wansing ] + * www-master - additional dependency for Sphinx-based documentation: + + python3-sphinx-rtd-theme + -- Pierre-Elliott Bécue <p...@debian.org> Mon, 18 Mar 2024 22:01:07 +0100 debian.org (73) stable; urgency=medium diff --git a/debian/control b/debian/control index 4de3955..cef3776 100644 --- a/debian/control +++ b/debian/control @@ -340,6 +340,7 @@ Depends: debiandoc-sgml, python3-distro-info, python3-sphinx, python3-stemmer, + python3-sphinx-rtd-theme, tex-gyre, texinfo, fonts-freefont-otf, -- 2.39.2