8000 backport to 2.x fixes for sphinx 1.8? · Issue #13258 · matplotlib/matplotlib · GitHub
[go: up one dir, main page]

Skip to content
backport to 2.x fixes for sphinx 1.8? #13258
Closed
@sandrotosi

Description

@sandrotosi

Hello,
in Debian we just got this bug report, http://bugs.debian.org/918896:

matplotlib2 fails to build with Sphinx 1.8, currently available in
experimental:

  # build the doc
  [...] /usr/bin/make -C doc html
  make[1]: Entering directory '/<<PKGBUILDDIR>>/doc'
  Running Sphinx v1.8.3

  Warning, treated as error:
  while setting up extension matplotlib.sphinxext.mathmpl: directive u'math' is already registered, it will be overridden
  make[1]: *** [Makefile:20: html] Error 2

This was fixed in matplotlib 3.x in this commit, please backport it:

https://github.com/matplotlib/matplotlib/commit/f87e9f46daf42ad7

That commit switches from generating PNG images for math formulas to MathJax
library, which renders the math formulas on client side. To package it for
Debian, please add this line to conf.py:

  mathjax_path = 'file:///usr/share/javascript/mathjax/MathJax.js?config=TeX-AMS-MML_HTMLorMML'

and make your documentation package depend on libjs-mathjax.

Also upstream has noticed that some math renders incorrectly with MathJax,
there is a follow-up commit which fixes it:

https://github.com/matplotlib/matplotlib/commit/a101de79650e077a

i see an issue was already reported and fixed at #12108 but it looks like the fixes where never backported to 2.x - would it be possible to do that?

thanks!

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions

      0