Changes between Initial Version and Version 1 of Ticket #13143, comment 26


Ignore:
Timestamp:
10/08/12 05:46:50 (9 years ago)
Author:
jhpalmieri
Comment:

Legend:

Unmodified
Added
Removed
Modified
  • Ticket #13143, comment 26

    initial v1  
    11Ideally, 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.
    22
    3 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
    4 
    5         app.connect('autodoc-process-docstring', process_mathjax)
    6 
    7 in the `setup` function in devel/sage/doc/common/conf.py, but I haven't gotten anywhere yet.
     3I'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 `process_mathjax` called like
     4{{{
     5    app.connect('autodoc-process-docstring', process_mathjax)
     6}}}
     7in the `setup` function at the end of devel/sage/doc/common/conf.py, but I haven't gotten anywhere yet.