Skip to content

Commit

Permalink
Incorporate Ivan's edits, fix the zipball name that he changed, and u…
Browse files Browse the repository at this point in the history
…pdate SVG description to list the browsers that it doesn't support
  • Loading branch information
dpvc committed Feb 26, 2012
1 parent a9dd723 commit 1d436aa
Show file tree
Hide file tree
Showing 2 changed files with 24 additions and 17 deletions.
31 changes: 18 additions & 13 deletions output.rst
Expand Up @@ -45,22 +45,27 @@ more comparable to other browsers. The HTML-CSS output uses web-based
fonts so that users don't have to have math fonts installed on their
computers, which introduces some printing issues in certain browsers.

The **SVG output processor** is new in MathJax version 2.0, and it uses
`Scalable Vector Graphics` to render the mathematics on the page. SVG
is supported in all the major browsers and most mobile devices; note,
however, that Internet Explorer prior to IE9 does not support SVG, and
IE9 only does in "IE9 standards mode", not its emulation modes for
earlier versions. The SVG output mode is high quality and slightly
faster than HTML-CSS, and it does not suffer from some of the
The **SVG output processor** is new in MathJax version 2.0, and it
uses `Scalable Vector Graphics` to render the mathematics on the page.
SVG is supported in all the major browsers and most mobile devices;
note, however, that Internet Explorer prior to IE9 does not support
SVG, and IE9 only does in "IE9 standards mode", not its emulation
modes for earlier versions. The SVG output mode is high quality and
slightly faster than HTML-CSS, and it does not suffer from some of the
font-related issues that HTML-CSS does, so prints well in all
browsers. This format also works well in some ebook readers (e.g.,
iBooks). The disadvantage of this mode is that it does not take
advantage of STIX fonts, and so only has access to the characters in
the web-based fonts, and it variable-width tables become fixed size
once they are typeset, and don't rescale if the window size changes
(for example). Since equation numbers are handled through
iBooks). The disadvantages of this mode are the following: first,
Internet Explorer only supports SVG in IE9 and later versions (and
then only in IE9 standards mode or above), and some versions of the
Android Internet browser don't have SVG enabled. Second, it does not
take advantage of STIX fonts, and so only has access to the characters
in the web-based fonts, and third, its variable-width tables become
fixed size once they are typeset, and don't rescale if the window size
changes (for example). Since equation numbers are handled through
variable-width tables, that means equation numbers may not stay at the
edge of the window if it is resized.
edge of the window if it is resized. For these reasons it is probably
best not to force the use of SVG output unless you have some control
over the browsers that are used to view your documents.

The **NativeMML output processor** uses the browser's internal MathML
support (if any) to render the mathematics. Currently, Firefox has
Expand Down
10 changes: 6 additions & 4 deletions start.rst
Expand Up @@ -108,10 +108,12 @@ Obtaining and Installing MathJax

The easiest way to set up MathJax is to obtain the v2.0 archive from
the `MathJax download page <http://www.mathjax.org/download/>`_ (you
should obtain a file named something like ``mathjax-MathJax-v2.0?.zip``).
This archive includes both the MathJax code and the MathJax webfonts,
so it is the only file you need. Note that this is different from v1.0
and earlier releases, which had the fonts separate from the rest of the code.
should obtain a file named something like
``mathjax-MathJax-v2.0-X-XXXXXXXX.zip`` where the X's are random
looking numbers and letters). This archive includes both the MathJax
code and the MathJax webfonts, so it is the only file you need. Note
that this is different from v1.0 and earlier releases, which had the
fonts separate from the rest of the code.

Unpack the archive and place the resulting MathJax folder onto your
web server at a convenient location where you can include it into your
Expand Down

0 comments on commit 1d436aa

Please sign in to comment.