Package: python3-openstackdocstheme
Version: 1.20.0-5
Severity: important
Tags: upstream

Dear Maintainer,

When doing a rebuild of all reverse-dependencies against Sphinx 7.1 (which is
currently available in experimental), we noticed that 104 packages FTBFS with
"dh_sphinxdoc: error: .../_static/underscore.js is missing" error [1].

All of these packages build-depend on python3-openstackdocstheme (except for
masakari, which build-depends implicitly via python3-os-api-ref).

The problem is that openstackdocstheme lists Sphinx' own JS files explicitly,
which may change from release to release. To fix this, please:

1. Upgrade to the latest upstream release (at least >= 2.3.0), that inherits
   from basic/layout.html instead of doing an own HTML template from scratch.

2. Cherry-pick the change [2] that I have just submitted upstream, to stop
   listing Sphinx JS files explicitly.

Please let me know if you need my help with this.

Another note: if you symlink jquery-3.2.1.js and jquery-3.2.1.min.js to the
respective files in libjs-jquery package, dh_sphinxdoc should do the same in
all reverse dependencies and generate a dependency on libjs-jquery.

[1]: http://qa-logs.debian.net/2023/07/30/diff.txt
[2]: https://review.opendev.org/c/openstack/openstackdocstheme/+/890587

--
Dmitry Shachnev

Attachment: signature.asc
Description: PGP signature

Reply via email to