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

[Julian Taylor]

On 06.03.2014 09:07, Dmitry Shachnev wrote:
> 
> Anyway, I think it is possible to implement this algorithm in
> dh_sphinxdoc:
> 
> | If an HTML file in a package references _static/mathjax/MathJax.js in
> | ‘script’ tag, and neither of _static/mathjax and _static/mathjax/MathJax.js
> | is already a symlink, then replace the _static/mathjax directory with
> | a symlink to /usr/share/javascript/mathjax/.
> 
> Will that work for you?
> 
> 

replacing a directory with a symlink is problematic as dpkg has special
rules for handling symlinks which can cause all kinds of upgrade issues.
The most common ones are files disappearing (see the plentora of missing
copyright bugs due to symlinking -doc packages) or unpack errors due to
ordering issues in the tarballs.

For this reason dh_linktree exists, please use that instead.
Another approach is to modify the path the webserver serves from, thats
what I do in IPython.