[Debian-med-packaging] Bug#1059699: python-propka-doc: mathjax not configured to display TeX equations in docs

Drew Parsons dparsons at debian.org
Sat Dec 30 11:03:18 GMT 2023


Package: python-propka-doc
Version: 3.5.0-3
Severity: normal
Tags: patch

The propka docs are not fully configured to display maths equations
(TeX).  You can see the problem opening
file:///usr/share/doc/python3-propka/html/index.html in the browser,
it displays "Heuristic \(\text{p}K_\text{a}\)" in the title.

The problem is the mathjax configuration. From the Debian privacy policy we strive
to make our documentation independent of internet acces, which you've
done in debian patch no-sphinx-sitemap.patch with

-mathjax_path = 'https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.0/MathJax.js?config=TeX-AMS-MML_HTMLorMML'
+mathjax_path = 'file:///usr/share/javascript/mathjax/MathJax.js'


However this is not enough for display.  The success of the MathJax.js
is senstive to the mathjax config requested.  You can see upstream
used "?config=TeX-AMS-MML_HTMLorMML".  So the maths in the docs should
render correctly if the patch is updated to

-mathjax_path = 'https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.0/MathJax.js?config=TeX-AMS-MML_HTMLorMML'
+mathjax_path = 'file:///usr/share/javascript/mathjax/MathJax.js?config=TeX-AMS-MML_HTMLorMML'



More information about the Debian-med-packaging mailing list