Dear Dmitry,
what looked strange to me is that previously I was able to build my
packages (pyresample in particular) without problems.
Now I get warnings about privacy breach so I had the impression that
something is moving in the wrong direction.
By the way adding small patch a patch to conf.py is not a problem for
me, so no problem.
kind regards
antonio
On Sat, 25 Sep 2021 21:53:27 +0300 Dmitry Shachnev <mity...@debian.org>
wrote:
Hi Drew, Antonio and all!
On Wed, Jun 09, 2021 at 03:13:47PM +0200, Drew Parsons wrote:
> Package: libjs-mathjax
> Version: 2.7.9+dfsg-1
> Severity: normal
>
> dh_sphinxdoc provides aids for automatically updating references to
> .js scripts used in docs generated through sphinx. In particular it
> helps maintain privacy policies by removing the need to reference
> external websites such as
> https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.9/MathJax.js
> from documentation.
>
> At the moment mathjax is not integrating into the dh_sphinxdoc
> capabilities. This means privacy hacks need to be made manually for
> every package that uses math formatting in its rst or md docs.
>
> Can mathjax be introduced to the dh_sphinxdoc system?
My recommendation is to add this line to your conf.py (using a patch):
mathjax_path =
'file:///usr/share/javascript/mathjax/MathJax.js?config=TeX-AMS-MML_HTMLorMML'
This is better than letting Sphinx generate URLs to some CDN and then
replacing them in dh_sphinxdoc. Any code to do automatic replacement is
error-prone, may not always detect the tags correctly, and may break
when something in Sphinx changes.
With this approach you will have correct URLs in tags from the very
beginning.
--
Dmitry Shachnev
--
Antonio Valentino