math processing error in Sage-5.10 documentation

[Kevin Halasz]

I built Sage from source in virtual machine running ubuntu 12.04 LTS.

When I try to build the reference manual and look at it, I get a [Math Processing Error] everywhere that there should be text formatted in tex math mode. I've tried doing a hard refresh (see http://meta.math.stackexchange.com/questions/3627/why-is-math-processing-error-all-over-the-place-today) to no avail.

I have noticed that a message flashes briefly on the bottom of the screen as the documentation loads. It says:

File failed to load: file:///home/khalasz/sage-5.10/devel/sage-main/doc/output/html/en/reference/groups/_static/fonts/HTML-CSS/TeX/png/imagedata.js

I have looked, and noticed that no such file exists in my sage directory.

I have tried the commands (from the directory ~/sage/devel/sage)

(1) ../../sage -docbuild --mathjax reference html
../../sage -docbuild --jsmath reference html
../../sage -docbuild -j reference html

all of which gave output that implied nothing was wrong

(2) ../../sage -docbuild reference latex

the last three lines of output here were :
[reference] writing... done
[reference] copying TeX support files... done
[reference] build succeeded, 11 warnings.
the warnings worried me, but scrolling through the rest of the output, it seemed that none of them were related to .../reference/groups/_static

(3) ../../sage -docbuild reference/groups/_static/fonts/HTML-CSS/TeX/png latex

which gave the output
[png ] Error: Source directory doesn't contain conf.py file.
which I can't make sense of, as I found several files named conf.py in the Sage-5.10 folder.

Any ideas about what could be wrong here would be much appreciated

[P Purkayastha]

You should ensure that nothing is blocking javascript in the notebook. In particular, the browser needs to be able to run mathjax in order to show the rendered math.

[Kevin Halasz]

mathjax works for most webpages in the same browser (Firefox 21.0), as well as all of the sage documentation in 5.2 and 4.8. 

I think the problem is that the file ///home/khalasz/sage-5.10/devel/sage-main/doc/output/html/en/reference/groups/_static/fonts/HTML-CSS/TeX/png/imagedata.js is missing. Is there some way to acquire it? I ran make ptest again overnight/today, to see if that would alleviate the problem. The final line of output from this command was:

make: *** [ptest] Error 4

I'm not sure what to make of this. Regardless, I again tried to build documentation after this, and still had the same problem. 

[P Purkayastha]

Maybe you can check what are the settings for mathjax in your browser.
Sage doesn't use png fonts by default and in fact the png fonts are not
shipped with the mathjax in Sage. It uses HTML+CSS by default. I don't
understand why it is defaulting to png in your case.

Maybe go to mathjax.org, right click on the math on top right and change
the renderer to HTML+CSS. Ideally, changing the preferences there
shouldn't affect what is used on the notebook, but it is worth giving a try.

On 07/03/2013 01:01 PM, Kevin Halasz wrote:
> mathjax works for most webpages in the same browser (Firefox 21.0), as
> well as all of the sage documentation in 5.2 and 4.8.
>
> I think the problem is that the
> file ///home/khalasz/sage-5.10/devel/sage-main/doc/output/html/en/reference/groups/_static/fonts/HTML-CSS/TeX/png/imagedata.js
> is missing. Is there some way to acquire it? I ran make ptest again
> overnight/today, to see if that would alleviate the problem. The final
> line of output from this command was:
>
> make: *** [ptest] Error 4
>
> I'm not sure what to make of this. Regardless, I again tried to build
> documentation after this, and still had the same problem.
>
> On Tuesday, July 2, 2013 12:29:32 AM UTC-7, Kevin Halasz wrote:
>
> I built Sage from source in virtual machine running ubuntu 12.04 LTS.
>
> When I try to build the reference manual and look at it, I get a
> [Math Processing Error] everywhere that there should be text
> formatted in tex math mode. I've tried doing a hard refresh (see
> http://meta.math.stackexchange.com/questions/3627/why-is-math-processing-error-all-over-the-place-today

> <http://meta.math.stackexchange.com/questions/3627/why-is-math-processing-error-all-over-the-place-today>)

> --
> You received this message because you are subscribed to a topic in the
> Google Groups "sage-support" group.
> To unsubscribe from this topic, visit
> https://groups.google.com/d/topic/sage-support/do7WnJ3fScY/unsubscribe.
> To unsubscribe from this group and all its topics, send an email to
> sage-support...@googlegroups.com.
> To post to this group, send email to sage-s...@googlegroups.com.
> Visit this group at http://groups.google.com/group/sage-support.
> For more options, visit https://groups.google.com/groups/opt_out.
>
>

[Kevin Halasz]

hmm. This is quite perplexing. My browser was already rendering math as HTML-CCS. I may be wrong, but it seems as though, as these documents are auto-generated by Sphinx, the problem is not with anything in my sage directory, but rather with Sphinx. If this is wrong, please let me know. I'm going to explore Sphinx and how it is used in Sage, but if you or anybody else has knowledge either of how Sphinx works or how it interacts with Sage, and is capable of pointing me in the right direction, or seeing a clear solution to the problem, I would be very grateful.

Anyway, P Purkayastha, thanks for the helpful ideas you've given me so far. All advice is greatly appreciated.

On Tuesday, July 2, 2013 12:29:32 AM UTC-7, Kevin Halasz wrote:

[P Purkayastha]

Can you try the following commands from the root of your sage
installation (where the main "sage" script is present):

make doc-clean
make doc-html-mathjax

On 07/03/2013 02:34 PM, Kevin Halasz wrote:
> hmm. This is quite perplexing. My browser was already rendering math as
> HTML-CCS. I may be wrong, but it seems as though, as these documents are
> auto-generated by Sphinx, the problem is not with anything in my sage
> directory, but rather with Sphinx. If this is wrong, please let me know.
> I'm going to explore Sphinx and how it is used in Sage, but if you or
> anybody else has knowledge either of how Sphinx works or how it
> interacts with Sage, and is capable of pointing me in the right
> direction, or seeing a clear solution to the problem, I would be very
> grateful.
>
> Anyway, P Purkayastha, thanks for the helpful ideas you've given me so
> far. All advice is greatly appreciated.
>
>
> On Tuesday, July 2, 2013 12:29:32 AM UTC-7, Kevin Halasz wrote:
>
> I built Sage from source in virtual machine running ubuntu 12.04 LTS.
>
> When I try to build the reference manual and look at it, I get a
> [Math Processing Error] everywhere that there should be text
> formatted in tex math mode. I've tried doing a hard refresh (see
> http://meta.math.stackexchange.com/questions/3627/why-is-math-processing-error-all-over-the-place-today

> <http://meta.math.stackexchange.com/questions/3627/why-is-math-processing-error-all-over-the-place-today>)

[Kevin Halasz]

I tried these commands. The problem, however, persists.