#13143: Use MathJax by default when building docs from Makefile
---------------------------------------------+------------------------------
Reporter: jhpalmieri | Owner: GeorgSWeber
Type: enhancement | Status: needs_review
Priority: minor | Milestone: sage-5.4
Component: build | Resolution:
Keywords: Makefile doc MathJax sd40 | Work issues:
Report Upstream: N/A | Reviewers:
Authors: John Palmieri | Merged in:
Dependencies: #9774, #13121 | Stopgaps:
---------------------------------------------+------------------------------
Comment (by jhpalmieri):
Ideally, this would be dealt with by Sphinx (and I'm glad you wrote to
sphinx-devel about it). But the documentation should be written so that it
looks good with or without !MathJax (or jsMath, in older versions of
Sage). The `picture` mode LaTeX code isn't processed correctly with these:
it only works with the pngmath Sphinx extension. (I checked some older
versions of Sage, and it didn't work with jsMath either.) So I think the
documentation should be changed: for pictures like these, someone should
just produce some pngs and then include them, as is done in several other
places in the docs. Indeed, that documentation should never have been
allowed in Sage in the first place, since it didn't build using Sphinx's
jsMath extension.
I've been playing around with Sphinx, trying to see if there is a way to
turn extensions like pngmath on or off using a function called like
app.connect('autodoc-process-docstring', process_mathjax)
in the `setup` function in devel/sage/doc/common/conf.py, but I haven't
gotten anywhere yet.
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/13143#comment:26>
Sage <http://www.sagemath.org>
Sage: Creating a Viable Open Source Alternative to Magma, Maple, Mathematica,
and MATLAB
--
You received this message because you are subscribed to the Google Groups
"sage-trac" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to
[email protected].
For more options, visit this group at
http://groups.google.com/group/sage-trac?hl=en.
