Debian RT - please install an additional dependency for Sphinx-based documentation on wolkenstein

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 <[email protected]>
PGP-Fingerprint: 496A C6E8 1442 4B34 8508  3529 59F1 87CA 156E B076

>From 72c0871fa470eeb30e8d4f3afa7d2b1f6ae17f68 Mon Sep 17 00:00:00 2001
From: Holger Wansing <[email protected]>
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 <[email protected]>  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