Bug#1064593: debian-policy: missing static resources for www.debian.org policy page

[James Addison <jay@jp-hosting.net>]

Package: debian-policy
Followup-For: Bug #1064593
X-Debbugs-Cc: hwansing@mailbox.org, stephane.blondon@gmail.com, spwhitton@spwhitton.name

Hello,

On Tue, 12 Mar 2024 22:53:54 +0100, Holger wrote:
> Stéphane Blondon <stephane.blondon@gmail.com> wrote (Mon, 4 Mar 2024 08:29:10 +0100):
> [...snip...]
> > The symlink is relative so it could be broken.
>
> It appears to me that the target for that symlink 
> (../../../../../sphinx_rtd_theme/static/css/theme.css) is not existing
> and therefore we get an empty file.

I'm not much of a perlmonger but this might be a problem somewhere in:

  https://sources.debian.org/src/sphinx/7.2.6-5/debian/dh-sphinxdoc/dh_sphinxdoc/?hl=409#L389-L413

When I modify that code to always follow the 'absolute link' path, I still
get relative links to the theme.css file in the debian/ package build dirs.

(note: this function also exists in imagemagick-6-doc, so any problem/fix
should not forget about that package too)

> I did some testing with debuild, and changed debian/rules (line 4) like
>
> -       dh $@ --with sphinxdoc
> +       dh $@

I don't think we should do this, if at all possible.  The dh-sphinxdoc helper
seems to handle a bunch of privacy and packaging-related fixups (#781849 for
example), and removing it could cause unexpected regressions elsewhere.

Regards,
James