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

[Stéphane Blondon <stephane.blondon@gmail.com>]

Hello,

Le dim. 3 mars 2024 à 11:49, Holger Wansing <hwansing@mailbox.org> a écrit :
> So, no problem with latest Sphinx version, it seems the integration in the
> debian-policy package is the problem (aka debian/rules) ...

Thank you for the search.

I have two wild guesses based on broken symlink assumption:

1. By dh_auto_install

buildd create symbolic links to the files (like theme.css) provided by
python3-sphinx-rtd-theme:
lrwxrwxrwx root/root         0 2024-02-24 12:39
./usr/share/doc/debian-policy/policy.html/_static/css/theme.css ->
../../../../../sphinx_rtd_theme/static/css/theme.css
(found in the log file)

Then the target dh_auto_install in debian/rules from debian_policy
moves files (line 15):
mv debian/tmp/* debian/debian-policy/

The symlink is relative so it could be broken.

2. By the webserver

In such case, the symlink is still correct after the install. However,
the target directory would be outside the static directories served by
the webserver. By default, they are not followed by the webserver to
avoid leaking data outside the static root directory.


Hope it helps,
Stéphane