Source: python-cogent
Version: 1.9-13
Severity: important
User: [email protected]
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

Attachment: signature.asc
Description: PGP signature

Reply via email to