[Debian-med-packaging] Bug#918829: python-cogent: FTBFS with Sphinx 1.8: No module named 'sphinx.ext.pngmath'

[Dmitry Shachnev]

Source: python-cogent
Version: 1.9-13
Severity: important
User: python-modules-team at lists.alioth.debian.org
Usertags: sphinx1.8

Dear Maintainer,

python-cogent fails to build with Sphinx 1.8, currently available in
experimental:

     debian/rules override_dh_auto_build-indep
  make[1]: Entering directory '/<<PKGBUILDDIR>>'
  sphinx-build -N -b html doc/sphinx/source build-doc/html
  Running Sphinx v1.8.3

  Extension error:
  Could not import extension sphinx.ext.pngmath (exception: No module named 'sphinx.ext.pngmath')
  make[1]: *** [debian/rules:75: override_dh_auto_build-indep] Error 2

The pngmath extension was deprecated in Sphinx 1.4 and has been removed [1]
in Sphinx 1.8. The recommended alternative is sphinx.ext.imgmath [2] which
also has SVG support in addition to PNG.

Alternatively, you can use sphinx.ext.mathjax extension which will make
the math formulas render via JavaScript. If you decide to use it, also add
this line to conf.py:

  mathjax_path = 'file:///usr/share/javascript/mathjax/MathJax.js?config=TeX-AMS-MML_HTMLorMML'

and make python-cogent-doc depend on libjs-mathjax.

[1]: https://github.com/sphinx-doc/sphinx/pull/4702
[2]: https://www.sphinx-doc.org/en/1.8/usage/extensions/math.html

--
Dmitry Shachnev
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 833 bytes
Desc: not available
URL: <http://alioth-lists.debian.net/pipermail/debian-med-packaging/attachments/20190109/84e68901/attachment-0001.sig>