Package: sphinx-common
Severity: serious

Hi,

dh_sphinxdoc does not work well with read-the-doc theme, apparently.
Debian policy document has switched to sphinx_rtd_theme recently (see
https://salsa.debian.org/dbnpolicy/policy/-/commit/686622814018b5a121252b189d99c1968f332b78
 )

However, the built document has a completely broken html layout, because
many files under _static/ are empty (0B size), most noteably 
_static/css/theme.css.

If I replace 
        dh $@ --with sphinxdoc
by
        dh $@
(so do not use dh_sphinxdoc), I get a valid html file with the theme
in use.

More details on that topic can be found in 
https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1064593

To get an idea of how it looks like, see
https://www.debian.org/doc/debian-policy/
(however, there is also an issue with rtd theme on debian.org, that's
why _static/css/ is completely missing there. That's an known issue,
but we need a valid document in the debian-policy binary package first,
to get the website problem fixed.)



So long
Holger


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

Reply via email to