[Python-modules-team] Bug#739300: dh_sphinxdoc: Please replace MathJax.js with links to the packaged libjs-mathjax

[Sebastian Ramacher]

Package: sphinx-common
Version: 1.2.1+dfsg-3
Severity: wishlist

Documentation using sphinx.ext.mathjax defaults to an online copy of
MathJax. It is possible to change mathjax_path in conf.py to use a
packaged or local copy. I think it would be a nice addition to
dh_sphinxdoc if it detected a local copy of MathJax.js and replaced it
with symlinks to the packaged one.

MathJax requires plenty of other files from libjs-mathjax, so simply
symlinking MathJax.js was not enough in my tests and ended up linking
/usr/share/javascript/mathjax into _static. I don't know if this is
easily doable in dh_sphinxdoc, but since sphinx.ext.mathjax is a
extension installed by python(3)-sphinx, I think dh_sphinxdoc is the
appropriate tool to handle this.

Regards
-- 
Sebastian Ramacher
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 819 bytes
Desc: Digital signature
URL: <http://lists.alioth.debian.org/pipermail/python-modules-team/attachments/20140217/23d62643/attachment.sig>