id,summary,reporter,owner,description,type,status,priority,milestone,component,resolution,keywords,cc,merged,author,reviewer,upstream,work_issues,branch,commit,dependencies,stopgaps
13143,Use MathJax by default when building docs from Makefile,jhpalmieri,GeorgSWeber,"At the moment, running `make` runs `make doc`, which in turn runs `make doc-html`. This runs Sphinx without the `-j` option, so !MathJax (or jsMath, pre #9774) is not used: png image files are used instead. Using png images is much slower, so we should use !MathJax (or jsMath) by default.
Timing and disk space information:
Tutorial without !MathJax:
{{{
$ rm -rf devel/sage/doc/output
$ time sage --docbuild tutorial html
...
real 2m17.950s
user 1m29.441s
sys 0m15.478s
$ du -s -h devel/sage/doc/output
3.9M output/
}}}
With !MathJax:
{{{
$ rm -rf devel/sage/doc/output
$ time sage --docbuild tutorial html -j
...
real 0m9.871s
user 0m6.530s
sys 0m1.739s
$ du -s -h devel/sage/doc/output
8.5M output/
}}}
When building all of the documentation, the disk space actually drops, going from about 320M (without !MathJax) to about 295M (with).
----------------
- Apply [attachment:trac_13143-root.v2.patch] to the root repo.
- Apply [attachment:trac_13143-sage.v2.patch] and [attachment:trac_13143-pictures.patch] to the Sage library.
This change was discussed [https://groups.google.com/d/topic/sage-devel/eHPVwaaqWSA/discussion on sage-devel].",enhancement,closed,minor,sage-5.5,build,fixed,Makefile doc MathJax sd40,nthiery,sage-5.5.beta2,John Palmieri,Dmitrii Pasechnik,N/A,,,,"#9774, #13121",