On Wed, Aug 25, 2010 at 14:39, TP <wing...@gmail.com> wrote: > On Wed, Aug 25, 2010 at 12:12 AM, TP <wing...@gmail.com> wrote: >> On Tue, Aug 24, 2010 at 4:04 PM, Fernando Perez <fperez....@gmail.com> wrote: >>> On Tue, Aug 24, 2010 at 2:58 PM, Kevin Dunn <kgd...@gmail.com> wrote: >>>> >>>> You can compare how the same HTML page is shown with MathJax or with >>>> Sphinx's built-in pngmath extension: >>>> * mathjax: http://connectmv.com/mathjax-extension/with-mathjax.html >>>> * pngmath: http://connectmv.com/mathjax-extension/with-pngmath.html >>>> >>>> MathJax shows better, and the HTML can also be zoomed, and the math >>>> will zoom clearly, unlike PNG. >>> >>> Wow, beautiful. Many thanks for posting this, I'm sure I'll be making >>> good use of it soon. >>> >>> Regards, >>> >>> f >> >> I've just tried mathjax on Windows XP with Sphinx 1.0.3 and ran into a >> two problems. First of all, when testing html files on my local >> computer, I couldn't figure out how to get >> >> mathjax_path = '/MathJax/MathJax.js' >> >> in my conf.py to work. At least I couldn't figure out where Firefox >> 3.6.8 thought /Mathjax was (it apparently wasn't C:\Mathjax). So I >> changed to: >> >> mathjax_path = 'file:///C:/MathJax/MathJax.js' >> >> but ran into problems with Sphinx 1.0.3 that are reported and "fixed" >> at >> http://bitbucket.org/birkenfeld/sphinx/issue/513/add_javascript-relative_uri-dont-support-local-file-url-syntax-in-sphinx >> (the solution is a hack but it works). >> >> I also had to install the mathjax fonts in >> \MathJax\fonts\HTML-CSS\TeX\otf\ by following the instructions given >> at http://www.mathjax.org/resources/faqs/#image-fonts to get Firefox >> to work with my local test files. Otherwise I got a message that my >> browser didn't support "web-based fonts". >> >> Now all I have to do is figure out how to use TeX :P >> > > More notes on using MathJax with Sphinx 1.0.3 on Windows: > > I decided it was better for local testing and sharing of the > preliminary builds to copy the MathJax folder to my Sphinx projects > _static directory rather than using it from C:\MathJax. Because it > takes up over 120MB(!) of disk space on Windows (only 16MB of that is > the total files size but all those tiny png files take lots of room), > I removed the docs, test, unpacked directories, and most importantly, > disabled image fonts by following the advice of > http://www.mathjax.org/resources/faqs/#fonts-too-big and deleting the > fonts\HTML-CSS\TeX\png directory. > > My conf.py file has the following mathjax_path for local testing: > > mathjax_path = 'MathJax/MathJax.js' > > which correctly points to _static/MathJax/MathJax.js in the generated HTML. > > It now takes a annoyingly long time to copy the entire _static > directory (still about 4MB in 440 files) every time I do a make. I > couldn't find any way to tell Sphinx not to bother copying the _static > directory? Once I've done a full make it doesn't change so copying the > entire thing over & over is unnecessary.
I had the same issue. MathJax's font files add up to a lot of overhead, so unfortunately it will take a while to run the Sphinx Makefile. While I develop and proof-read my documentation, I resorted to placing the MathJax files on a different, but local server, and then added a line to my Sphinx template to load MathJax from there. > Additionally, as http://www.mathjax.org/resources/faqs/#ie8-slow says, > you need to add the following to the beginning of the <head> tag in > order for Internet Explorer 8 not to be ridiculously slow when > displaying pages with MathJax (even only small amounts): > > <meta http-equiv="X-UA-Compatible" content="IE=EmulateIE7"> > > I spent awhile looking in the source code for how to add meta tags > using Sphinx (hint: you can't use the extrahead template block because > that comes too late in the <head> tag). > > As it turns out, all you need to do is use the following docutils meta > directive (http://docutils.sourceforge.net/docs/ref/rst/directives.html#meta) > at the top of each .rst file that contains MathJax code. > > .. meta:: > :http-equiv=X-UA-Compatible: IE=EmulateIE7 > > If you have lots of pages with MathJax, you could alternatively put > the above in the new rst_prolog setting > (http://sphinx.pocoo.org/config.html#confval-rst_prolog) in your > conf.py file. Thanks for the info about the Meta tag for Windows users. That will be helpful when I upload my documentation later, Kevin -- You received this message because you are subscribed to the Google Groups "sphinx-dev" group. To post to this group, send email to sphinx-...@googlegroups.com. To unsubscribe from this group, send email to sphinx-dev+unsubscr...@googlegroups.com. For more options, visit this group at http://groups.google.com/group/sphinx-dev?hl=en.
