Fix a bunch of documentation typos (from Carol Fisher)
This commit is contained in:
parent
2cd3e23b58
commit
fe11cb9807
|
@ -7,7 +7,7 @@ the wider community of MathJax users. The MathJax project maintains
|
|||
forums where users can ask questions about how to use MathJax, make
|
||||
suggestions about future features for MathJax, and present their own
|
||||
solutions to problems that they have faced. There is also a
|
||||
bug-traking system where you can report errors that you have found
|
||||
bug-tracking system where you can report errors that you have found
|
||||
with MathJax in your environment.
|
||||
|
||||
|
||||
|
@ -26,7 +26,7 @@ place to find the examples you are looking for.
|
|||
If you want to discuss MathJax development, please use the `MathJax Dev Google
|
||||
Group <http://groups.google.com/group/mathjax-dev>`_. We made this group
|
||||
to discuss anything beyond what an end-user might be interested in, so if you
|
||||
having any suggestions or questions about MathJax performance, technology, or
|
||||
have any suggestions or questions about MathJax performance, technology, or
|
||||
design, feel free to submit it to the group.
|
||||
|
||||
The community is only as good as the users who participate, so if
|
||||
|
@ -46,7 +46,7 @@ and work hard to respond to problems quickly.
|
|||
Before you create a new issue, however, please search the issues to see if it
|
||||
has already been reported. You could also be using an outdated version of
|
||||
MathJax, so be sure to :ref:`upgrade your copy <getting-mathjax-git>` to verify
|
||||
that the problem persists in the lastest version.
|
||||
that the problem persists in the latest version.
|
||||
|
||||
|
||||
.. _badge:
|
||||
|
|
|
@ -16,7 +16,7 @@ Because of MathJax's modular design, you do not need to use all three
|
|||
of these components. For example, you could use the `tex2jax`
|
||||
preprocessor and the TeX input processor, but the NativeMML output
|
||||
processor, so that your mathematics is entered in TeX format, but
|
||||
displayed as MathML. Or you could use the `mml2jax` reprocessor and
|
||||
displayed as MathML. Or you could use the `mml2jax` preprocessor and
|
||||
MathML input processor with the HTML-CSS output processor to make
|
||||
MathML available in browsers that don't have native MathML support.
|
||||
It is also possible to have MathJax select the output processor for
|
||||
|
@ -42,7 +42,7 @@ even with a pure MathML workflow.
|
|||
MathML in HTML pages
|
||||
====================
|
||||
|
||||
For MathML that is handled via the pre-processor, you should not use
|
||||
For MathML that is handled via the preprocessor, you should not use
|
||||
the named MathML entities, but rather use the numeric entities like
|
||||
``√`` or unicode characters embedded in the page itself. The
|
||||
reason is that entities are replaced by the browser before MathJax
|
||||
|
@ -87,7 +87,7 @@ The deficiencies include:
|
|||
``msgroup``, ``msrow``, ``mscarries``, and ``mscarry``.
|
||||
|
||||
- Limited support for line breaking (they are only allowed in direct
|
||||
children of ``mrow`` or implied ``mrow`` elements.
|
||||
children of ``mrow`` or implied ``mrow`` elements).
|
||||
|
||||
- No support for alignment groups in table.
|
||||
|
||||
|
|
|
@ -23,76 +23,76 @@ would set the ``fadeoutTime`` option to 2000 milliseconds (2 seconds).
|
|||
|
||||
.. describe:: messageStyle: { ... }
|
||||
|
||||
This sets the CSS styles to be used for the font warning message
|
||||
window. See the ``extensions/FontWarnings.js`` file for details of
|
||||
what are set by default. See the :ref:`CSS style objects
|
||||
<css-style-objects>` for details about how to specify CSS styles
|
||||
via javascript objects.
|
||||
This sets the CSS styles to be used for the font warning message
|
||||
window. See the ``extensions/FontWarnings.js`` file for details of
|
||||
what are set by default. See the :ref:`CSS style objects
|
||||
<css-style-objects>` for details about how to specify CSS styles
|
||||
via javascript objects.
|
||||
|
||||
.. describe:: Message: { ... }
|
||||
|
||||
This block contains HTML snippets to be used for the various
|
||||
messages that the FontWarning extension can produce. There are
|
||||
three messages that you can redefine to suit your needs:
|
||||
This block contains HTML snippets to be used for the various
|
||||
messages that the FontWarning extension can produce. There are
|
||||
three messages that you can redefine to suit your needs:
|
||||
|
||||
.. describe:: webFont: [ ... ]
|
||||
.. describe:: webFont: [ ... ]
|
||||
|
||||
The message used for when MathJax uses web-based fonts (rather
|
||||
than local fonts installed on the user's system).
|
||||
The message used for when MathJax uses web-based fonts (rather
|
||||
than local fonts installed on the user's system).
|
||||
|
||||
.. describe:: imageFonts: [ ... ]
|
||||
.. describe:: imageFonts: [ ... ]
|
||||
|
||||
The message used for when MathJax must use image fonts rather
|
||||
than local or web-based fonts (for those browsers that don't
|
||||
handle the ``@font-face`` CSS directive).
|
||||
The message used for when MathJax must use image fonts rather
|
||||
than local or web-based fonts (for those browsers that don't
|
||||
handle the ``@font-face`` CSS directive).
|
||||
|
||||
.. describe:: noFonts: [ ... ]
|
||||
.. describe:: noFonts: [ ... ]
|
||||
|
||||
The message used when MathJax is unable to find any font to use
|
||||
(i.e., neither local nor web-based nor image-based fonts are
|
||||
available).
|
||||
The message used when MathJax is unable to find any font to use
|
||||
(i.e., neither local nor web-based nor image-based fonts are
|
||||
available).
|
||||
|
||||
Any message that is set to ``null`` rather than an HTML snippet
|
||||
array will not be presented to the user, so you can set, for
|
||||
example, the ``webFont`` message to ``null`` in order to have the
|
||||
``imageFonts`` and ``noFonts`` messages, but no message if MathJax
|
||||
uses web-based fonts.
|
||||
Any message that is set to ``null`` rather than an HTML snippet
|
||||
array will not be presented to the user, so you can set, for
|
||||
example, the ``webFont`` message to ``null`` in order to have the
|
||||
``imageFonts`` and ``noFonts`` messages, but no message if MathJax
|
||||
uses web-based fonts.
|
||||
|
||||
See the description of :ref:`HTML snippets <html-snippets>` for
|
||||
details about how to describe the messages using HTML snippets.
|
||||
Note that in addition to the usual rules for defining such
|
||||
snippets, the FontWarnings snippets can include references to
|
||||
pre-defined snippets (that represent elements common to all three
|
||||
messages). These are defined below in the ``HTML`` block, and are
|
||||
referenced using ``["name"]`` within the snippet, where `name` is
|
||||
the name of one of the snippets defined in the ``HTML``
|
||||
configuration block. For example
|
||||
See the description of :ref:`HTML snippets <html-snippets>` for
|
||||
details about how to describe the messages using HTML snippets.
|
||||
Note that in addition to the usual rules for defining such
|
||||
snippets, the FontWarnings snippets can include references to
|
||||
pre-defined snippets (that represent elements common to all three
|
||||
messages). These are defined below in the ``HTML`` block, and are
|
||||
referenced using ``["name"]`` within the snippet, where `name` is
|
||||
the name of one of the snippets defined in the ``HTML``
|
||||
configuration block. For example
|
||||
|
||||
.. code-block:: javascript
|
||||
.. code-block:: javascript
|
||||
|
||||
Message: {
|
||||
noFonts: [
|
||||
["closeBox"],
|
||||
"MathJax is unable to locate a font to use to display ",
|
||||
"its mathematics, and image fonts are not available, so it ",
|
||||
"is falling back on generic unicode characters in hopes that ",
|
||||
"your browser will be able to display them. Some characters ",
|
||||
"may not show up properly, or possibly not at all.",
|
||||
["fonts"],
|
||||
["webfonts"]
|
||||
]
|
||||
}
|
||||
Message: {
|
||||
noFonts: [
|
||||
["closeBox"],
|
||||
"MathJax is unable to locate a font to use to display ",
|
||||
"its mathematics, and image fonts are not available, so it ",
|
||||
"is falling back on generic unicode characters in hopes that ",
|
||||
"your browser will be able to display them. Some characters ",
|
||||
"may not show up properly, or possibly not at all.",
|
||||
["fonts"],
|
||||
["webfonts"]
|
||||
]
|
||||
}
|
||||
|
||||
refers to the ``closeBox``, ``fonts`` and ``webfonts`` snippets in
|
||||
refers to the ``closeBox``, ``fonts`` and ``webfonts`` snippets
|
||||
declared in the ``HTML`` section.
|
||||
|
||||
.. describe:: HTML: { ... }
|
||||
|
||||
This object defines HTML snippets that are common to more than one
|
||||
message in the ``Message`` section above. They can be called in
|
||||
by using ``["name"]`` in an HTML snippet, where `name` refers to
|
||||
the name of the snippet in the ``HTML`` block. The pre-defined
|
||||
snippets are:
|
||||
message in the ``Message`` section above. They can be included in
|
||||
other HTML snippets by by using ``["name"]`` in an HTML snippet,
|
||||
where `name` refers to the name of the snippet in the ``HTML``
|
||||
block. The pre-defined snippets are:
|
||||
|
||||
.. describe:: closeBox
|
||||
|
||||
|
|
|
@ -32,8 +32,8 @@ in your document.
|
|||
|
||||
The HTML-CSS output processor produces high-quality output in all
|
||||
major browsers, with results that are consistent across browsers and
|
||||
operating systems. This is MathJax's primary output mode. It's major
|
||||
advantage is its quality and consistency; it's drawback is that it is
|
||||
operating systems. This is MathJax's primary output mode. Its major
|
||||
advantage is its quality and consistency; its drawback is that it is
|
||||
slower than the NativeMML mode at rendering the mathematics. (The
|
||||
HTML-CSS processor has not yet been optimized for speed, so you can
|
||||
expect some improvement in the future. Note that IE8 in "IE8
|
||||
|
@ -77,7 +77,7 @@ are the configuration files that end in ``_HTMLorMML``.
|
|||
If you are doing your own configuration, there is a special configuration
|
||||
file that you can include that will choose between NativeMML and HTML-CSS
|
||||
depending on the browser in use. To invoke it, add ``"MMLorHTML.js"`` to
|
||||
your configurations `config` array, and **do not** include an output
|
||||
your configuration's `config` array, and **do not** include an output
|
||||
processor in your `jax` array; MathJax will fill that in for you based on
|
||||
the abilities of your user's browser.
|
||||
|
||||
|
@ -88,7 +88,7 @@ the abilities of your user's browser.
|
|||
|
||||
You can customize which choice to make on a browser-by-browser basis
|
||||
or a global basis. See the ``config/default.js`` file or the
|
||||
:ref:`Configuring MMLorHTML <configure-MMLorHTML>` section for futher
|
||||
:ref:`Configuring MMLorHTML <configure-MMLorHTML>` section for further
|
||||
details. As an example, this configuration tells MathJax to use HTML-CSS
|
||||
output rather than native MathML support for Firefox:
|
||||
|
||||
|
@ -106,7 +106,7 @@ output rather than native MathML support for Firefox:
|
|||
With this configuration, MathML output will be used only for IE with the
|
||||
MathPlayer plugin (Firefox is the only other browser to have native MathML
|
||||
support that is sufficient for use with MathJax). Note, however, that a
|
||||
user can employ the MathJax contectual menu to select the other renderer if
|
||||
user can employ the MathJax contextual menu to select the other renderer if
|
||||
he or she wishes.
|
||||
|
||||
MathJax produces MathML that models the underlying mathematics as best
|
||||
|
@ -144,11 +144,11 @@ mode. You can accomplish this by including the line
|
|||
|
||||
at the top of the ``<head>`` section of your HTML documents. This
|
||||
lets you keep the strict `DOCTYPE` for validation purposes, while
|
||||
still managing to get reasonable perforance from Internet Explorer
|
||||
still managing to get reasonable performance from Internet Explorer
|
||||
8. Note that this line must come at the beginning of the ``<head>``,
|
||||
before any stylesheets or other content are loaded.
|
||||
|
||||
Altertnatively, you can use the `MMLorHTML` configuration file
|
||||
Alternatively, you can use the `MMLorHTML` configuration file
|
||||
described above to select NativeMML output when possible, and request
|
||||
that your users install the `MathPlayer plugin
|
||||
<http://www.dessci.com/en/products/mathplayer/>`_, which will render
|
||||
|
|
|
@ -21,7 +21,7 @@ Using MathJax in a Theme File
|
|||
Most web-based content-management systems include a theme or template
|
||||
layer that determines how the pages look, and that loads information
|
||||
common to all pages. Such theme files provide one popular way to
|
||||
include MathJax in your web templates in the absense of
|
||||
include MathJax in your web templates in the absence of
|
||||
MathJax-specific plugins for the system you are using. To take
|
||||
advantage of this approach, you will need access to your theme files,
|
||||
which probably means you need to be an administrator for the site; if
|
||||
|
@ -64,8 +64,8 @@ theme/template only. If you change themes or update your theme, you
|
|||
will have to repeat these steps.
|
||||
|
||||
|
||||
Insructions for Specific Platforms
|
||||
==================================
|
||||
Instructions for Specific Platforms
|
||||
===================================
|
||||
|
||||
Some programs, such as WordPress and Moveable Type, allow you to edit
|
||||
template files from inside their administrator interfaces. Specific
|
||||
|
|
|
@ -26,13 +26,13 @@ Using MathJax in Movable Type
|
|||
src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML">
|
||||
</script>
|
||||
|
||||
to load MathJax from our distributed netowrk service.
|
||||
to load MathJax from our distributed network service.
|
||||
|
||||
.. image:: ../images/mt_head.png
|
||||
|
||||
5. Save the file. This will enable MathJax with both TeX and MathML
|
||||
input, so you should be able to start adding mathematical content to
|
||||
your pages. If you need to adjust the configuraiton, see
|
||||
your pages. If you need to adjust the configuration, see
|
||||
:ref:`Configuring MathJax <loading>` for more details.
|
||||
|
||||
|
||||
|
|
|
@ -38,5 +38,5 @@ better choice than editing the theme directly.
|
|||
|
||||
4. Save the file. This will enable MathJax with both TeX and MathML
|
||||
input, so you should be able to start adding mathematical content to
|
||||
your pages. If you need to adjust the configuraiton, see
|
||||
your pages. If you need to adjust the configuration, see
|
||||
:ref:`Configuring MathJax <loading>` for more details.
|
||||
|
|
|
@ -39,7 +39,7 @@ you need a LaTeX-to-HTML converter, you should consider `other options
|
|||
TeX and LaTeX math delimiters
|
||||
=============================
|
||||
|
||||
By default, the `tex2jax` preprocesor defines the LaTeX math delimiters,
|
||||
By default, the `tex2jax` preprocessor defines the LaTeX math delimiters,
|
||||
which are ``\(...\)`` for in-line math, and ``\[...\]`` for displayed
|
||||
equations. It also defines the TeX delimiters ``$$...$$`` for displayed
|
||||
equations, but it does **not** define ``$...$`` as in-line math
|
||||
|
@ -72,7 +72,7 @@ See the ``config/default.js`` file, or the :ref:`tex2jax configuration
|
|||
options <configure-tex2jax>` page, for additional configuration
|
||||
parameters that you can specify for the `tex2jax` preprocessor,
|
||||
which is the component of MathJax that identifies TeX notation within
|
||||
the page).
|
||||
the page.
|
||||
|
||||
|
||||
TeX and LaTeX in HTML documents
|
||||
|
@ -86,7 +86,7 @@ Also, since the mathematics is initially given as text on the page,
|
|||
you need to be careful that your mathematics doesn't look like HTML
|
||||
tags to the browser (which parses the page before MathJax gets to see
|
||||
it). In particular, that means that you have to be careful about
|
||||
things like less-than and greater-than signs (``<``and ``>``), and
|
||||
things like less-than and greater-than signs (``<`` and ``>``), and
|
||||
ampersands (``&``), which have special meaning to the browsers. For
|
||||
example,
|
||||
|
||||
|
@ -99,10 +99,10 @@ beginning of a tag named ``y`` (even though there is no such tag in
|
|||
HTML). When this happens, the browser will think the tag continues up
|
||||
to the next ``>`` in the document (typically the end of the next
|
||||
actual tag in the HTML file), and you may notice that you are missing
|
||||
part of the text of the document. In the example above, the `` we
|
||||
have ...`` will not be displayed because the browser thinks it is
|
||||
part of the text of the document. In the example above, the "``we
|
||||
have ...``" will not be displayed because the browser thinks it is
|
||||
part of the tag starting at ``<y``. This is one indication you can
|
||||
use to spot this prooblem; it is a common error and should be avoided.
|
||||
use to spot this problem; it is a common error and should be avoided.
|
||||
|
||||
Usually, it is sufficient to simply put spaces around these symbols to
|
||||
cause the browser to avoid them, so
|
||||
|
@ -261,7 +261,7 @@ the paragraph, use
|
|||
}
|
||||
}
|
||||
|
||||
You may also wish to set the font family, as the default is "serif"
|
||||
You may also wish to set the font family, as the default is "serif".
|
||||
|
||||
|
||||
noUndefined
|
||||
|
@ -269,13 +269,13 @@ noUndefined
|
|||
|
||||
The `noUndefined` extension causes undefined control sequences to be
|
||||
shown as their macro names rather than generating error messages. So
|
||||
``$X_{\xxx}$`` would display as an "X" with a subscript consiting of the
|
||||
``$X_{\xxx}$`` would display as an "X" with a subscript consisting of the
|
||||
text ``\xxx`` in red.
|
||||
|
||||
This extension is loaded by all the combined configuration files that
|
||||
include the TeX input processor. To enable the `noUndefined` extension
|
||||
in your own configuration, or to modify its parameters, add something like
|
||||
the following ro your :meth:`MathJax.Hub.Config()` call:
|
||||
the following to your :meth:`MathJax.Hub.Config()` call:
|
||||
|
||||
.. code-block:: javascript
|
||||
|
||||
|
@ -899,7 +899,6 @@ N
|
|||
\nolimits
|
||||
\normalsize
|
||||
\not
|
||||
\notag AMSmath
|
||||
\notag [AMSmath]
|
||||
\notin
|
||||
\nparallel AMSsymbols
|
||||
|
@ -1119,7 +1118,6 @@ T
|
|||
|
||||
.. code-block:: latex
|
||||
|
||||
\tag AMSmath
|
||||
\tag [AMSmath]
|
||||
\tan
|
||||
\tanh
|
||||
|
@ -1273,7 +1271,7 @@ Environments
|
|||
------------
|
||||
|
||||
LaTeX environments of the form ``\begin{XXX} ... \end{XXX}`` are
|
||||
preovided where ``XXX`` is one of the following:
|
||||
provided where ``XXX`` is one of the following:
|
||||
|
||||
.. code-block:: latex
|
||||
|
||||
|
|
|
@ -59,7 +59,7 @@ details.
|
|||
If your page simply loads ``MathJax.js`` and relies on
|
||||
``config/MathJax.js``, then you will need to modify your ``<script>`` tag
|
||||
in order to use MathJax v1.1. This is because MathJax no longer loads a
|
||||
default configuration file; you are required to explicity specify the
|
||||
default configuration file; you are required to explicitly specify the
|
||||
configuration file if you use one. Furthermore, the name of the
|
||||
``config/MathJax.js`` file was a source of confusion, so it has been
|
||||
renamed ``config/default.js`` instead. Thus, if you used
|
||||
|
@ -163,7 +163,7 @@ Of course, you can load any configuration file that you wish, or use a
|
|||
|
||||
The use of ``cdn.mathjax.org`` is governed by its `terms of service
|
||||
<http://www.mathjax.org/download/mathjax-cdn-terms-of-service/>`_, so be
|
||||
sure to read that before linked to the MathJax CDN server.
|
||||
sure to read that before linking to the MathJax CDN server.
|
||||
|
||||
|
||||
Change in default TeX delimiters
|
||||
|
@ -255,5 +255,5 @@ development continues.
|
|||
|
||||
We apologize for the inconvenience of having to switch distributions, but
|
||||
the git-to-svn bridge we tried to implement to keep both copies in synch
|
||||
turned out to be unreliable, and so the SourceForge disrtibution was
|
||||
retired in favor of the GitHub site.
|
||||
turned out to be unreliable, and so the SourceForge distribution was
|
||||
retired in favor of the GitHub site.
|
||||
|
|
|
@ -56,7 +56,7 @@ the wider community of MathJax users. The MathJax project maintains
|
|||
forums where users can ask questions about how to use MathJax, make
|
||||
suggestions about future features for MathJax, and present their own
|
||||
solutions to problems that they have faced. There is also a
|
||||
bug-traking system where you can report errors that you have found
|
||||
bug-tracking system where you can report errors that you have found
|
||||
with MathJax in your environment.</p>
|
||||
<div class="section" id="forums">
|
||||
<span id="community-forums"></span><h2>Forums<a class="headerlink" href="#forums" title="Permalink to this headline">¶</a></h2>
|
||||
|
@ -68,7 +68,7 @@ place to find the examples you are looking for.</p>
|
|||
<p>If you want to discuss MathJax development, please use the <a class="reference external" href="http://groups.google.com/group/mathjax-dev">MathJax Dev Google
|
||||
Group</a>. We made this group
|
||||
to discuss anything beyond what an end-user might be interested in, so if you
|
||||
having any suggestions or questions about MathJax performance, technology, or
|
||||
have any suggestions or questions about MathJax performance, technology, or
|
||||
design, feel free to submit it to the group.</p>
|
||||
<p>The community is only as good as the users who participate, so if
|
||||
you have something to offer, please take time to make a post on one of
|
||||
|
@ -81,7 +81,7 @@ and work hard to respond to problems quickly.</p>
|
|||
<p>Before you create a new issue, however, please search the issues to see if it
|
||||
has already been reported. You could also be using an outdated version of
|
||||
MathJax, so be sure to <a class="reference internal" href="installation.html#getting-mathjax-git"><em>upgrade your copy</em></a> to verify
|
||||
that the problem persists in the lastest version.</p>
|
||||
that the problem persists in the latest version.</p>
|
||||
</div>
|
||||
<div class="section" id="powered-by-mathjax">
|
||||
<span id="badge"></span><h2>“Powered by MathJax”<a class="headerlink" href="#powered-by-mathjax" title="Permalink to this headline">¶</a></h2>
|
||||
|
|
|
@ -121,7 +121,7 @@ MathML that works in all modern browsers.</p>
|
|||
</li>
|
||||
</ul>
|
||||
<hr class="docutils" />
|
||||
<p>This version of the documentation was built March 09, 2011.</p>
|
||||
<p>This version of the documentation was built March 21, 2011.</p>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
|
|
|
@ -62,7 +62,7 @@ that it can be displayed by the browser’s native MathML support.</p>
|
|||
of these components. For example, you could use the <cite>tex2jax</cite>
|
||||
preprocessor and the TeX input processor, but the NativeMML output
|
||||
processor, so that your mathematics is entered in TeX format, but
|
||||
displayed as MathML. Or you could use the <cite>mml2jax</cite> reprocessor and
|
||||
displayed as MathML. Or you could use the <cite>mml2jax</cite> preprocessor and
|
||||
MathML input processor with the HTML-CSS output processor to make
|
||||
MathML available in browsers that don’t have native MathML support.
|
||||
It is also possible to have MathJax select the output processor for
|
||||
|
@ -84,7 +84,7 @@ the source markup, and so on, so there is added value to using MathJax
|
|||
even with a pure MathML workflow.</p>
|
||||
<div class="section" id="mathml-in-html-pages">
|
||||
<h2>MathML in HTML pages<a class="headerlink" href="#mathml-in-html-pages" title="Permalink to this headline">¶</a></h2>
|
||||
<p>For MathML that is handled via the pre-processor, you should not use
|
||||
<p>For MathML that is handled via the preprocessor, you should not use
|
||||
the named MathML entities, but rather use the numeric entities like
|
||||
<tt class="docutils literal"><span class="pre">&#x221A;</span></tt> or unicode characters embedded in the page itself. The
|
||||
reason is that entities are replaced by the browser before MathJax
|
||||
|
@ -122,7 +122,7 @@ coming.</p>
|
|||
<li>No support for the elementary math tags: <tt class="docutils literal"><span class="pre">mstack</span></tt>, <tt class="docutils literal"><span class="pre">mlongdiv</span></tt>,
|
||||
<tt class="docutils literal"><span class="pre">msgroup</span></tt>, <tt class="docutils literal"><span class="pre">msrow</span></tt>, <tt class="docutils literal"><span class="pre">mscarries</span></tt>, and <tt class="docutils literal"><span class="pre">mscarry</span></tt>.</li>
|
||||
<li>Limited support for line breaking (they are only allowed in direct
|
||||
children of <tt class="docutils literal"><span class="pre">mrow</span></tt> or implied <tt class="docutils literal"><span class="pre">mrow</span></tt> elements.</li>
|
||||
children of <tt class="docutils literal"><span class="pre">mrow</span></tt> or implied <tt class="docutils literal"><span class="pre">mrow</span></tt> elements).</li>
|
||||
<li>No support for alignment groups in table.</li>
|
||||
<li>No support for right-to-left rendering.</li>
|
||||
</ul>
|
||||
|
|
|
@ -119,32 +119,32 @@ messages). These are defined below in the <tt class="docutils literal"><span cl
|
|||
referenced using <tt class="docutils literal"><span class="pre">["name"]</span></tt> within the snippet, where <cite>name</cite> is
|
||||
the name of one of the snippets defined in the <tt class="docutils literal"><span class="pre">HTML</span></tt>
|
||||
configuration block. For example</p>
|
||||
<div class="highlight-javascript"><pre> Message: {
|
||||
noFonts: [
|
||||
["closeBox"],
|
||||
"MathJax is unable to locate a font to use to display ",
|
||||
"its mathematics, and image fonts are not available, so it ",
|
||||
"is falling back on generic unicode characters in hopes that ",
|
||||
"your browser will be able to display them. Some characters ",
|
||||
"may not show up properly, or possibly not at all.",
|
||||
["fonts"],
|
||||
["webfonts"]
|
||||
]
|
||||
}
|
||||
|
||||
refers to the ``closeBox``, ``fonts`` and ``webfonts`` snippets in
|
||||
declared in the ``HTML`` section.</pre>
|
||||
<div class="highlight-javascript"><div class="highlight"><pre><span class="nx">Message</span><span class="o">:</span> <span class="p">{</span>
|
||||
<span class="nx">noFonts</span><span class="o">:</span> <span class="p">[</span>
|
||||
<span class="p">[</span><span class="s2">"closeBox"</span><span class="p">],</span>
|
||||
<span class="s2">"MathJax is unable to locate a font to use to display "</span><span class="p">,</span>
|
||||
<span class="s2">"its mathematics, and image fonts are not available, so it "</span><span class="p">,</span>
|
||||
<span class="s2">"is falling back on generic unicode characters in hopes that "</span><span class="p">,</span>
|
||||
<span class="s2">"your browser will be able to display them. Some characters "</span><span class="p">,</span>
|
||||
<span class="s2">"may not show up properly, or possibly not at all."</span><span class="p">,</span>
|
||||
<span class="p">[</span><span class="s2">"fonts"</span><span class="p">],</span>
|
||||
<span class="p">[</span><span class="s2">"webfonts"</span><span class="p">]</span>
|
||||
<span class="p">]</span>
|
||||
<span class="p">}</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
<p>refers to the <tt class="docutils literal"><span class="pre">closeBox</span></tt>, <tt class="docutils literal"><span class="pre">fonts</span></tt> and <tt class="docutils literal"><span class="pre">webfonts</span></tt> snippets
|
||||
declared in the <tt class="docutils literal"><span class="pre">HTML</span></tt> section.</p>
|
||||
</dd></dl>
|
||||
|
||||
<dl class="describe">
|
||||
<dt>
|
||||
<tt class="descname">HTML: { ... }</tt></dt>
|
||||
<dd><p>This object defines HTML snippets that are common to more than one
|
||||
message in the <tt class="docutils literal"><span class="pre">Message</span></tt> section above. They can be called in
|
||||
by using <tt class="docutils literal"><span class="pre">["name"]</span></tt> in an HTML snippet, where <cite>name</cite> refers to
|
||||
the name of the snippet in the <tt class="docutils literal"><span class="pre">HTML</span></tt> block. The pre-defined
|
||||
snippets are:</p>
|
||||
message in the <tt class="docutils literal"><span class="pre">Message</span></tt> section above. They can be included in
|
||||
other HTML snippets by by using <tt class="docutils literal"><span class="pre">["name"]</span></tt> in an HTML snippet,
|
||||
where <cite>name</cite> refers to the name of the snippet in the <tt class="docutils literal"><span class="pre">HTML</span></tt>
|
||||
block. The pre-defined snippets are:</p>
|
||||
<dl class="describe">
|
||||
<dt>
|
||||
<tt class="descname">closeBox</tt></dt>
|
||||
|
|
|
@ -74,8 +74,8 @@ For example</p>
|
|||
in your document.</p>
|
||||
<p>The HTML-CSS output processor produces high-quality output in all
|
||||
major browsers, with results that are consistent across browsers and
|
||||
operating systems. This is MathJax’s primary output mode. It’s major
|
||||
advantage is its quality and consistency; it’s drawback is that it is
|
||||
operating systems. This is MathJax’s primary output mode. Its major
|
||||
advantage is its quality and consistency; its drawback is that it is
|
||||
slower than the NativeMML mode at rendering the mathematics. (The
|
||||
HTML-CSS processor has not yet been optimized for speed, so you can
|
||||
expect some improvement in the future. Note that IE8 in “IE8
|
||||
|
@ -113,7 +113,7 @@ are the configuration files that end in <tt class="docutils literal"><span class
|
|||
<p>If you are doing your own configuration, there is a special configuration
|
||||
file that you can include that will choose between NativeMML and HTML-CSS
|
||||
depending on the browser in use. To invoke it, add <tt class="docutils literal"><span class="pre">"MMLorHTML.js"</span></tt> to
|
||||
your configurations <cite>config</cite> array, and <strong>do not</strong> include an output
|
||||
your configuration’s <cite>config</cite> array, and <strong>do not</strong> include an output
|
||||
processor in your <cite>jax</cite> array; MathJax will fill that in for you based on
|
||||
the abilities of your user’s browser.</p>
|
||||
<div class="highlight-javascript"><div class="highlight"><pre><span class="nx">config</span><span class="o">:</span> <span class="p">[</span><span class="s2">"MMLorHTML.js"</span><span class="p">],</span>
|
||||
|
@ -122,7 +122,7 @@ the abilities of your user’s browser.</p>
|
|||
</div>
|
||||
<p>You can customize which choice to make on a browser-by-browser basis
|
||||
or a global basis. See the <tt class="docutils literal"><span class="pre">config/default.js</span></tt> file or the
|
||||
<a class="reference internal" href="options/MMLorHTML.html#configure-mmlorhtml"><em>Configuring MMLorHTML</em></a> section for futher
|
||||
<a class="reference internal" href="options/MMLorHTML.html#configure-mmlorhtml"><em>Configuring MMLorHTML</em></a> section for further
|
||||
details. As an example, this configuration tells MathJax to use HTML-CSS
|
||||
output rather than native MathML support for Firefox:</p>
|
||||
<div class="highlight-html"><div class="highlight"><pre><span class="nt"><script </span><span class="na">type=</span><span class="s">"text/x-mathjax-config"</span><span class="nt">></span>
|
||||
|
@ -138,7 +138,7 @@ output rather than native MathML support for Firefox:</p>
|
|||
<p>With this configuration, MathML output will be used only for IE with the
|
||||
MathPlayer plugin (Firefox is the only other browser to have native MathML
|
||||
support that is sufficient for use with MathJax). Note, however, that a
|
||||
user can employ the MathJax contectual menu to select the other renderer if
|
||||
user can employ the MathJax contextual menu to select the other renderer if
|
||||
he or she wishes.</p>
|
||||
<p>MathJax produces MathML that models the underlying mathematics as best
|
||||
it can, rather than using complicated hacks to improve output for a
|
||||
|
@ -168,10 +168,10 @@ mode. You can accomplish this by including the line</p>
|
|||
</div>
|
||||
<p>at the top of the <tt class="docutils literal"><span class="pre"><head></span></tt> section of your HTML documents. This
|
||||
lets you keep the strict <cite>DOCTYPE</cite> for validation purposes, while
|
||||
still managing to get reasonable perforance from Internet Explorer
|
||||
still managing to get reasonable performance from Internet Explorer
|
||||
8. Note that this line must come at the beginning of the <tt class="docutils literal"><span class="pre"><head></span></tt>,
|
||||
before any stylesheets or other content are loaded.</p>
|
||||
<p>Altertnatively, you can use the <cite>MMLorHTML</cite> configuration file
|
||||
<p>Alternatively, you can use the <cite>MMLorHTML</cite> configuration file
|
||||
described above to select NativeMML output when possible, and request
|
||||
that your users install the <a class="reference external" href="http://www.dessci.com/en/products/mathplayer/">MathPlayer plugin</a>, which will render
|
||||
the mathematics much more quickly.</p>
|
||||
|
|
|
@ -63,7 +63,7 @@ use MathJax by modifying the theme or template for your wiki or blog.</p>
|
|||
<p>Most web-based content-management systems include a theme or template
|
||||
layer that determines how the pages look, and that loads information
|
||||
common to all pages. Such theme files provide one popular way to
|
||||
include MathJax in your web templates in the absense of
|
||||
include MathJax in your web templates in the absence of
|
||||
MathJax-specific plugins for the system you are using. To take
|
||||
advantage of this approach, you will need access to your theme files,
|
||||
which probably means you need to be an administrator for the site; if
|
||||
|
@ -98,8 +98,8 @@ the file if it contains no <tt class="docutils literal"><span class="pre"></h
|
|||
theme/template only. If you change themes or update your theme, you
|
||||
will have to repeat these steps.</p>
|
||||
</div>
|
||||
<div class="section" id="insructions-for-specific-platforms">
|
||||
<h2>Insructions for Specific Platforms<a class="headerlink" href="#insructions-for-specific-platforms" title="Permalink to this headline">¶</a></h2>
|
||||
<div class="section" id="instructions-for-specific-platforms">
|
||||
<h2>Instructions for Specific Platforms<a class="headerlink" href="#instructions-for-specific-platforms" title="Permalink to this headline">¶</a></h2>
|
||||
<p>Some programs, such as WordPress and Moveable Type, allow you to edit
|
||||
template files from inside their administrator interfaces. Specific
|
||||
instructions for these are given via the links below.</p>
|
||||
|
@ -122,7 +122,7 @@ instructions for these are given via the links below.</p>
|
|||
<ul>
|
||||
<li><a class="reference internal" href="#">Using MathJax in popular web platforms</a><ul>
|
||||
<li><a class="reference internal" href="#using-mathjax-in-a-theme-file">Using MathJax in a Theme File</a></li>
|
||||
<li><a class="reference internal" href="#insructions-for-specific-platforms">Insructions for Specific Platforms</a><ul>
|
||||
<li><a class="reference internal" href="#instructions-for-specific-platforms">Instructions for Specific Platforms</a><ul>
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
|
|
|
@ -75,14 +75,14 @@ and open the <cite>HTML Head</cite> template.</p>
|
|||
<span class="nt"></script></span>
|
||||
</pre></div>
|
||||
</div>
|
||||
<p>to load MathJax from our distributed netowrk service.</p>
|
||||
<p>to load MathJax from our distributed network service.</p>
|
||||
<blockquote>
|
||||
<div><img alt="../_images/mt_head.png" src="../_images/mt_head.png" />
|
||||
</div></blockquote>
|
||||
</li>
|
||||
<li><p class="first">Save the file. This will enable MathJax with both TeX and MathML
|
||||
input, so you should be able to start adding mathematical content to
|
||||
your pages. If you need to adjust the configuraiton, see
|
||||
your pages. If you need to adjust the configuration, see
|
||||
<a class="reference internal" href="../configuration.html#loading"><em>Configuring MathJax</em></a> for more details.</p>
|
||||
</li>
|
||||
</ol>
|
||||
|
|
|
@ -84,7 +84,7 @@ bottom of the file.</p>
|
|||
</li>
|
||||
<li><p class="first">Save the file. This will enable MathJax with both TeX and MathML
|
||||
input, so you should be able to start adding mathematical content to
|
||||
your pages. If you need to adjust the configuraiton, see
|
||||
your pages. If you need to adjust the configuration, see
|
||||
<a class="reference internal" href="../configuration.html#loading"><em>Configuring MathJax</em></a> for more details.</p>
|
||||
</li>
|
||||
</ol>
|
||||
|
|
File diff suppressed because one or more lines are too long
|
@ -78,7 +78,7 @@ environments. You must use HTML to handle such formatting tasks. If
|
|||
you need a LaTeX-to-HTML converter, you should consider <a class="reference external" href="http://www.google.com/search?q=latex+to+html+converter">other options</a>.</p>
|
||||
<div class="section" id="tex-and-latex-math-delimiters">
|
||||
<h2>TeX and LaTeX math delimiters<a class="headerlink" href="#tex-and-latex-math-delimiters" title="Permalink to this headline">¶</a></h2>
|
||||
<p>By default, the <cite>tex2jax</cite> preprocesor defines the LaTeX math delimiters,
|
||||
<p>By default, the <cite>tex2jax</cite> preprocessor defines the LaTeX math delimiters,
|
||||
which are <tt class="docutils literal"><span class="pre">\(...\)</span></tt> for in-line math, and <tt class="docutils literal"><span class="pre">\[...\]</span></tt> for displayed
|
||||
equations. It also defines the TeX delimiters <tt class="docutils literal"><span class="pre">$$...$$</span></tt> for displayed
|
||||
equations, but it does <strong>not</strong> define <tt class="docutils literal"><span class="pre">$...$</span></tt> as in-line math
|
||||
|
@ -108,7 +108,7 @@ math delimiter.)</p>
|
|||
options</em></a> page, for additional configuration
|
||||
parameters that you can specify for the <cite>tex2jax</cite> preprocessor,
|
||||
which is the component of MathJax that identifies TeX notation within
|
||||
the page).</p>
|
||||
the page.</p>
|
||||
</div>
|
||||
<div class="section" id="tex-and-latex-in-html-documents">
|
||||
<h2>TeX and LaTeX in HTML documents<a class="headerlink" href="#tex-and-latex-in-html-documents" title="Permalink to this headline">¶</a></h2>
|
||||
|
@ -120,7 +120,7 @@ Also, since the mathematics is initially given as text on the page,
|
|||
you need to be careful that your mathematics doesn’t look like HTML
|
||||
tags to the browser (which parses the page before MathJax gets to see
|
||||
it). In particular, that means that you have to be careful about
|
||||
things like less-than and greater-than signs (<tt class="docutils literal"><span class="pre"><``and</span> <span class="pre">``></span></tt>), and
|
||||
things like less-than and greater-than signs (<tt class="docutils literal"><span class="pre"><</span></tt> and <tt class="docutils literal"><span class="pre">></span></tt>), and
|
||||
ampersands (<tt class="docutils literal"><span class="pre">&</span></tt>), which have special meaning to the browsers. For
|
||||
example,</p>
|
||||
<div class="highlight-latex"><div class="highlight"><pre>... when <span class="s">$</span><span class="nb">x<y</span><span class="s">$</span> we have ...
|
||||
|
@ -131,10 +131,10 @@ beginning of a tag named <tt class="docutils literal"><span class="pre">y</span>
|
|||
HTML). When this happens, the browser will think the tag continues up
|
||||
to the next <tt class="docutils literal"><span class="pre">></span></tt> in the document (typically the end of the next
|
||||
actual tag in the HTML file), and you may notice that you are missing
|
||||
part of the text of the document. In the example above, the `` we
|
||||
have ...`` will not be displayed because the browser thinks it is
|
||||
part of the text of the document. In the example above, the “<tt class="docutils literal"><span class="pre">we</span>
|
||||
<span class="pre">have</span> <span class="pre">...</span></tt>” will not be displayed because the browser thinks it is
|
||||
part of the tag starting at <tt class="docutils literal"><span class="pre"><y</span></tt>. This is one indication you can
|
||||
use to spot this prooblem; it is a common error and should be avoided.</p>
|
||||
use to spot this problem; it is a common error and should be avoided.</p>
|
||||
<p>Usually, it is sufficient to simply put spaces around these symbols to
|
||||
cause the browser to avoid them, so</p>
|
||||
<div class="highlight-latex"><div class="highlight"><pre>... when <span class="s">$</span><span class="nb">x < y</span><span class="s">$</span> we have ...
|
||||
|
@ -261,18 +261,18 @@ the paragraph, use</p>
|
|||
<span class="p">}</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
<p>You may also wish to set the font family, as the default is “serif”</p>
|
||||
<p>You may also wish to set the font family, as the default is “serif”.</p>
|
||||
</div>
|
||||
<div class="section" id="noundefined">
|
||||
<h3>noUndefined<a class="headerlink" href="#noundefined" title="Permalink to this headline">¶</a></h3>
|
||||
<p>The <cite>noUndefined</cite> extension causes undefined control sequences to be
|
||||
shown as their macro names rather than generating error messages. So
|
||||
<tt class="docutils literal"><span class="pre">$X_{\xxx}$</span></tt> would display as an “X” with a subscript consiting of the
|
||||
<tt class="docutils literal"><span class="pre">$X_{\xxx}$</span></tt> would display as an “X” with a subscript consisting of the
|
||||
text <tt class="docutils literal"><span class="pre">\xxx</span></tt> in red.</p>
|
||||
<p>This extension is loaded by all the combined configuration files that
|
||||
include the TeX input processor. To enable the <cite>noUndefined</cite> extension
|
||||
in your own configuration, or to modify its parameters, add something like
|
||||
the following ro your <tt class="xref py py-meth docutils literal"><span class="pre">MathJax.Hub.Config()</span></tt> call:</p>
|
||||
the following to your <tt class="xref py py-meth docutils literal"><span class="pre">MathJax.Hub.Config()</span></tt> call:</p>
|
||||
<div class="highlight-javascript"><div class="highlight"><pre><span class="nx">TeX</span><span class="o">:</span> <span class="p">{</span>
|
||||
<span class="nx">extensions</span><span class="o">:</span> <span class="p">[</span><span class="s2">"noUndefined.js"</span><span class="p">],</span>
|
||||
<span class="nx">noUndefined</span><span class="o">:</span> <span class="p">{</span>
|
||||
|
@ -864,7 +864,6 @@ be loaded automatically when the macro or environment is first used.</p>
|
|||
<span class="k">\nolimits</span>
|
||||
<span class="k">\normalsize</span>
|
||||
<span class="k">\not</span>
|
||||
<span class="k">\notag</span> AMSmath
|
||||
<span class="k">\notag</span> [AMSmath]
|
||||
<span class="k">\notin</span>
|
||||
<span class="k">\nparallel</span> AMSsymbols
|
||||
|
@ -1078,8 +1077,7 @@ be loaded automatically when the macro or environment is first used.</p>
|
|||
</div>
|
||||
<div class="section" id="t">
|
||||
<h3>T<a class="headerlink" href="#t" title="Permalink to this headline">¶</a></h3>
|
||||
<div class="highlight-latex"><div class="highlight"><pre><span class="k">\tag</span> AMSmath
|
||||
<span class="k">\tag</span> [AMSmath]
|
||||
<div class="highlight-latex"><div class="highlight"><pre><span class="k">\tag</span> [AMSmath]
|
||||
<span class="k">\tan</span>
|
||||
<span class="k">\tanh</span>
|
||||
<span class="k">\tau</span>
|
||||
|
@ -1226,7 +1224,7 @@ be loaded automatically when the macro or environment is first used.</p>
|
|||
<div class="section" id="environments">
|
||||
<h3>Environments<a class="headerlink" href="#environments" title="Permalink to this headline">¶</a></h3>
|
||||
<p>LaTeX environments of the form <tt class="docutils literal"><span class="pre">\begin{XXX}</span> <span class="pre">...</span> <span class="pre">\end{XXX}</span></tt> are
|
||||
preovided where <tt class="docutils literal"><span class="pre">XXX</span></tt> is one of the following:</p>
|
||||
provided where <tt class="docutils literal"><span class="pre">XXX</span></tt> is one of the following:</p>
|
||||
<div class="highlight-latex"><div class="highlight"><pre>align [AMSmath]
|
||||
align* [AMSmath]
|
||||
alignat [AMSmath]
|
||||
|
|
|
@ -97,7 +97,7 @@ details.</p>
|
|||
<p>If your page simply loads <tt class="docutils literal"><span class="pre">MathJax.js</span></tt> and relies on
|
||||
<tt class="docutils literal"><span class="pre">config/MathJax.js</span></tt>, then you will need to modify your <tt class="docutils literal"><span class="pre"><script></span></tt> tag
|
||||
in order to use MathJax v1.1. This is because MathJax no longer loads a
|
||||
default configuration file; you are required to explicity specify the
|
||||
default configuration file; you are required to explicitly specify the
|
||||
configuration file if you use one. Furthermore, the name of the
|
||||
<tt class="docutils literal"><span class="pre">config/MathJax.js</span></tt> file was a source of confusion, so it has been
|
||||
renamed <tt class="docutils literal"><span class="pre">config/default.js</span></tt> instead. Thus, if you used</p>
|
||||
|
@ -180,7 +180,7 @@ and reliable.</p>
|
|||
<tt class="docutils literal"><span class="pre">text/x=mathajx-config</span></tt> block to configure MathJax in-line.
|
||||
<a class="reference internal" href="configuration.html#loading-cdn"><em>More details</em></a> are available, if you need them.</p>
|
||||
<p>The use of <tt class="docutils literal"><span class="pre">cdn.mathjax.org</span></tt> is governed by its <a class="reference external" href="http://www.mathjax.org/download/mathjax-cdn-terms-of-service/">terms of service</a>, so be
|
||||
sure to read that before linked to the MathJax CDN server.</p>
|
||||
sure to read that before linking to the MathJax CDN server.</p>
|
||||
</div>
|
||||
<div class="section" id="change-in-default-tex-delimiters">
|
||||
<h2>Change in default TeX delimiters<a class="headerlink" href="#change-in-default-tex-delimiters" title="Permalink to this headline">¶</a></h2>
|
||||
|
@ -257,7 +257,7 @@ GitHub. This will allow you to keep your copy of MathJax up to date as
|
|||
development continues.</p>
|
||||
<p>We apologize for the inconvenience of having to switch distributions, but
|
||||
the git-to-svn bridge we tried to implement to keep both copies in synch
|
||||
turned out to be unreliable, and so the SourceForge disrtibution was
|
||||
turned out to be unreliable, and so the SourceForge distribution was
|
||||
retired in favor of the GitHub site.</p>
|
||||
</div>
|
||||
</div>
|
||||
|
|
|
@ -7,7 +7,7 @@ the wider community of MathJax users. The MathJax project maintains
|
|||
forums where users can ask questions about how to use MathJax, make
|
||||
suggestions about future features for MathJax, and present their own
|
||||
solutions to problems that they have faced. There is also a
|
||||
bug-traking system where you can report errors that you have found
|
||||
bug-tracking system where you can report errors that you have found
|
||||
with MathJax in your environment.
|
||||
|
||||
|
||||
|
@ -26,7 +26,7 @@ place to find the examples you are looking for.
|
|||
If you want to discuss MathJax development, please use the `MathJax Dev Google
|
||||
Group <http://groups.google.com/group/mathjax-dev>`_. We made this group
|
||||
to discuss anything beyond what an end-user might be interested in, so if you
|
||||
having any suggestions or questions about MathJax performance, technology, or
|
||||
have any suggestions or questions about MathJax performance, technology, or
|
||||
design, feel free to submit it to the group.
|
||||
|
||||
The community is only as good as the users who participate, so if
|
||||
|
@ -46,7 +46,7 @@ and work hard to respond to problems quickly.
|
|||
Before you create a new issue, however, please search the issues to see if it
|
||||
has already been reported. You could also be using an outdated version of
|
||||
MathJax, so be sure to :ref:`upgrade your copy <getting-mathjax-git>` to verify
|
||||
that the problem persists in the lastest version.
|
||||
that the problem persists in the latest version.
|
||||
|
||||
|
||||
.. _badge:
|
||||
|
|
|
@ -16,7 +16,7 @@ Because of MathJax's modular design, you do not need to use all three
|
|||
of these components. For example, you could use the `tex2jax`
|
||||
preprocessor and the TeX input processor, but the NativeMML output
|
||||
processor, so that your mathematics is entered in TeX format, but
|
||||
displayed as MathML. Or you could use the `mml2jax` reprocessor and
|
||||
displayed as MathML. Or you could use the `mml2jax` preprocessor and
|
||||
MathML input processor with the HTML-CSS output processor to make
|
||||
MathML available in browsers that don't have native MathML support.
|
||||
It is also possible to have MathJax select the output processor for
|
||||
|
@ -42,7 +42,7 @@ even with a pure MathML workflow.
|
|||
MathML in HTML pages
|
||||
====================
|
||||
|
||||
For MathML that is handled via the pre-processor, you should not use
|
||||
For MathML that is handled via the preprocessor, you should not use
|
||||
the named MathML entities, but rather use the numeric entities like
|
||||
``√`` or unicode characters embedded in the page itself. The
|
||||
reason is that entities are replaced by the browser before MathJax
|
||||
|
@ -87,7 +87,7 @@ The deficiencies include:
|
|||
``msgroup``, ``msrow``, ``mscarries``, and ``mscarry``.
|
||||
|
||||
- Limited support for line breaking (they are only allowed in direct
|
||||
children of ``mrow`` or implied ``mrow`` elements.
|
||||
children of ``mrow`` or implied ``mrow`` elements).
|
||||
|
||||
- No support for alignment groups in table.
|
||||
|
||||
|
|
|
@ -23,76 +23,76 @@ would set the ``fadeoutTime`` option to 2000 milliseconds (2 seconds).
|
|||
|
||||
.. describe:: messageStyle: { ... }
|
||||
|
||||
This sets the CSS styles to be used for the font warning message
|
||||
window. See the ``extensions/FontWarnings.js`` file for details of
|
||||
what are set by default. See the :ref:`CSS style objects
|
||||
<css-style-objects>` for details about how to specify CSS styles
|
||||
via javascript objects.
|
||||
This sets the CSS styles to be used for the font warning message
|
||||
window. See the ``extensions/FontWarnings.js`` file for details of
|
||||
what are set by default. See the :ref:`CSS style objects
|
||||
<css-style-objects>` for details about how to specify CSS styles
|
||||
via javascript objects.
|
||||
|
||||
.. describe:: Message: { ... }
|
||||
|
||||
This block contains HTML snippets to be used for the various
|
||||
messages that the FontWarning extension can produce. There are
|
||||
three messages that you can redefine to suit your needs:
|
||||
This block contains HTML snippets to be used for the various
|
||||
messages that the FontWarning extension can produce. There are
|
||||
three messages that you can redefine to suit your needs:
|
||||
|
||||
.. describe:: webFont: [ ... ]
|
||||
.. describe:: webFont: [ ... ]
|
||||
|
||||
The message used for when MathJax uses web-based fonts (rather
|
||||
than local fonts installed on the user's system).
|
||||
The message used for when MathJax uses web-based fonts (rather
|
||||
than local fonts installed on the user's system).
|
||||
|
||||
.. describe:: imageFonts: [ ... ]
|
||||
.. describe:: imageFonts: [ ... ]
|
||||
|
||||
The message used for when MathJax must use image fonts rather
|
||||
than local or web-based fonts (for those browsers that don't
|
||||
handle the ``@font-face`` CSS directive).
|
||||
The message used for when MathJax must use image fonts rather
|
||||
than local or web-based fonts (for those browsers that don't
|
||||
handle the ``@font-face`` CSS directive).
|
||||
|
||||
.. describe:: noFonts: [ ... ]
|
||||
.. describe:: noFonts: [ ... ]
|
||||
|
||||
The message used when MathJax is unable to find any font to use
|
||||
(i.e., neither local nor web-based nor image-based fonts are
|
||||
available).
|
||||
The message used when MathJax is unable to find any font to use
|
||||
(i.e., neither local nor web-based nor image-based fonts are
|
||||
available).
|
||||
|
||||
Any message that is set to ``null`` rather than an HTML snippet
|
||||
array will not be presented to the user, so you can set, for
|
||||
example, the ``webFont`` message to ``null`` in order to have the
|
||||
``imageFonts`` and ``noFonts`` messages, but no message if MathJax
|
||||
uses web-based fonts.
|
||||
Any message that is set to ``null`` rather than an HTML snippet
|
||||
array will not be presented to the user, so you can set, for
|
||||
example, the ``webFont`` message to ``null`` in order to have the
|
||||
``imageFonts`` and ``noFonts`` messages, but no message if MathJax
|
||||
uses web-based fonts.
|
||||
|
||||
See the description of :ref:`HTML snippets <html-snippets>` for
|
||||
details about how to describe the messages using HTML snippets.
|
||||
Note that in addition to the usual rules for defining such
|
||||
snippets, the FontWarnings snippets can include references to
|
||||
pre-defined snippets (that represent elements common to all three
|
||||
messages). These are defined below in the ``HTML`` block, and are
|
||||
referenced using ``["name"]`` within the snippet, where `name` is
|
||||
the name of one of the snippets defined in the ``HTML``
|
||||
configuration block. For example
|
||||
See the description of :ref:`HTML snippets <html-snippets>` for
|
||||
details about how to describe the messages using HTML snippets.
|
||||
Note that in addition to the usual rules for defining such
|
||||
snippets, the FontWarnings snippets can include references to
|
||||
pre-defined snippets (that represent elements common to all three
|
||||
messages). These are defined below in the ``HTML`` block, and are
|
||||
referenced using ``["name"]`` within the snippet, where `name` is
|
||||
the name of one of the snippets defined in the ``HTML``
|
||||
configuration block. For example
|
||||
|
||||
.. code-block:: javascript
|
||||
.. code-block:: javascript
|
||||
|
||||
Message: {
|
||||
noFonts: [
|
||||
["closeBox"],
|
||||
"MathJax is unable to locate a font to use to display ",
|
||||
"its mathematics, and image fonts are not available, so it ",
|
||||
"is falling back on generic unicode characters in hopes that ",
|
||||
"your browser will be able to display them. Some characters ",
|
||||
"may not show up properly, or possibly not at all.",
|
||||
["fonts"],
|
||||
["webfonts"]
|
||||
]
|
||||
}
|
||||
Message: {
|
||||
noFonts: [
|
||||
["closeBox"],
|
||||
"MathJax is unable to locate a font to use to display ",
|
||||
"its mathematics, and image fonts are not available, so it ",
|
||||
"is falling back on generic unicode characters in hopes that ",
|
||||
"your browser will be able to display them. Some characters ",
|
||||
"may not show up properly, or possibly not at all.",
|
||||
["fonts"],
|
||||
["webfonts"]
|
||||
]
|
||||
}
|
||||
|
||||
refers to the ``closeBox``, ``fonts`` and ``webfonts`` snippets in
|
||||
refers to the ``closeBox``, ``fonts`` and ``webfonts`` snippets
|
||||
declared in the ``HTML`` section.
|
||||
|
||||
.. describe:: HTML: { ... }
|
||||
|
||||
This object defines HTML snippets that are common to more than one
|
||||
message in the ``Message`` section above. They can be called in
|
||||
by using ``["name"]`` in an HTML snippet, where `name` refers to
|
||||
the name of the snippet in the ``HTML`` block. The pre-defined
|
||||
snippets are:
|
||||
message in the ``Message`` section above. They can be included in
|
||||
other HTML snippets by by using ``["name"]`` in an HTML snippet,
|
||||
where `name` refers to the name of the snippet in the ``HTML``
|
||||
block. The pre-defined snippets are:
|
||||
|
||||
.. describe:: closeBox
|
||||
|
||||
|
|
|
@ -32,8 +32,8 @@ in your document.
|
|||
|
||||
The HTML-CSS output processor produces high-quality output in all
|
||||
major browsers, with results that are consistent across browsers and
|
||||
operating systems. This is MathJax's primary output mode. It's major
|
||||
advantage is its quality and consistency; it's drawback is that it is
|
||||
operating systems. This is MathJax's primary output mode. Its major
|
||||
advantage is its quality and consistency; its drawback is that it is
|
||||
slower than the NativeMML mode at rendering the mathematics. (The
|
||||
HTML-CSS processor has not yet been optimized for speed, so you can
|
||||
expect some improvement in the future. Note that IE8 in "IE8
|
||||
|
@ -77,7 +77,7 @@ are the configuration files that end in ``_HTMLorMML``.
|
|||
If you are doing your own configuration, there is a special configuration
|
||||
file that you can include that will choose between NativeMML and HTML-CSS
|
||||
depending on the browser in use. To invoke it, add ``"MMLorHTML.js"`` to
|
||||
your configurations `config` array, and **do not** include an output
|
||||
your configuration's `config` array, and **do not** include an output
|
||||
processor in your `jax` array; MathJax will fill that in for you based on
|
||||
the abilities of your user's browser.
|
||||
|
||||
|
@ -88,7 +88,7 @@ the abilities of your user's browser.
|
|||
|
||||
You can customize which choice to make on a browser-by-browser basis
|
||||
or a global basis. See the ``config/default.js`` file or the
|
||||
:ref:`Configuring MMLorHTML <configure-MMLorHTML>` section for futher
|
||||
:ref:`Configuring MMLorHTML <configure-MMLorHTML>` section for further
|
||||
details. As an example, this configuration tells MathJax to use HTML-CSS
|
||||
output rather than native MathML support for Firefox:
|
||||
|
||||
|
@ -106,7 +106,7 @@ output rather than native MathML support for Firefox:
|
|||
With this configuration, MathML output will be used only for IE with the
|
||||
MathPlayer plugin (Firefox is the only other browser to have native MathML
|
||||
support that is sufficient for use with MathJax). Note, however, that a
|
||||
user can employ the MathJax contectual menu to select the other renderer if
|
||||
user can employ the MathJax contextual menu to select the other renderer if
|
||||
he or she wishes.
|
||||
|
||||
MathJax produces MathML that models the underlying mathematics as best
|
||||
|
@ -144,11 +144,11 @@ mode. You can accomplish this by including the line
|
|||
|
||||
at the top of the ``<head>`` section of your HTML documents. This
|
||||
lets you keep the strict `DOCTYPE` for validation purposes, while
|
||||
still managing to get reasonable perforance from Internet Explorer
|
||||
still managing to get reasonable performance from Internet Explorer
|
||||
8. Note that this line must come at the beginning of the ``<head>``,
|
||||
before any stylesheets or other content are loaded.
|
||||
|
||||
Altertnatively, you can use the `MMLorHTML` configuration file
|
||||
Alternatively, you can use the `MMLorHTML` configuration file
|
||||
described above to select NativeMML output when possible, and request
|
||||
that your users install the `MathPlayer plugin
|
||||
<http://www.dessci.com/en/products/mathplayer/>`_, which will render
|
||||
|
|
|
@ -21,7 +21,7 @@ Using MathJax in a Theme File
|
|||
Most web-based content-management systems include a theme or template
|
||||
layer that determines how the pages look, and that loads information
|
||||
common to all pages. Such theme files provide one popular way to
|
||||
include MathJax in your web templates in the absense of
|
||||
include MathJax in your web templates in the absence of
|
||||
MathJax-specific plugins for the system you are using. To take
|
||||
advantage of this approach, you will need access to your theme files,
|
||||
which probably means you need to be an administrator for the site; if
|
||||
|
@ -64,8 +64,8 @@ theme/template only. If you change themes or update your theme, you
|
|||
will have to repeat these steps.
|
||||
|
||||
|
||||
Insructions for Specific Platforms
|
||||
==================================
|
||||
Instructions for Specific Platforms
|
||||
===================================
|
||||
|
||||
Some programs, such as WordPress and Moveable Type, allow you to edit
|
||||
template files from inside their administrator interfaces. Specific
|
||||
|
|
|
@ -26,13 +26,13 @@ Using MathJax in Movable Type
|
|||
src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML">
|
||||
</script>
|
||||
|
||||
to load MathJax from our distributed netowrk service.
|
||||
to load MathJax from our distributed network service.
|
||||
|
||||
.. image:: ../images/mt_head.png
|
||||
|
||||
5. Save the file. This will enable MathJax with both TeX and MathML
|
||||
input, so you should be able to start adding mathematical content to
|
||||
your pages. If you need to adjust the configuraiton, see
|
||||
your pages. If you need to adjust the configuration, see
|
||||
:ref:`Configuring MathJax <loading>` for more details.
|
||||
|
||||
|
||||
|
|
|
@ -38,5 +38,5 @@ better choice than editing the theme directly.
|
|||
|
||||
4. Save the file. This will enable MathJax with both TeX and MathML
|
||||
input, so you should be able to start adding mathematical content to
|
||||
your pages. If you need to adjust the configuraiton, see
|
||||
your pages. If you need to adjust the configuration, see
|
||||
:ref:`Configuring MathJax <loading>` for more details.
|
||||
|
|
|
@ -39,7 +39,7 @@ you need a LaTeX-to-HTML converter, you should consider `other options
|
|||
TeX and LaTeX math delimiters
|
||||
=============================
|
||||
|
||||
By default, the `tex2jax` preprocesor defines the LaTeX math delimiters,
|
||||
By default, the `tex2jax` preprocessor defines the LaTeX math delimiters,
|
||||
which are ``\(...\)`` for in-line math, and ``\[...\]`` for displayed
|
||||
equations. It also defines the TeX delimiters ``$$...$$`` for displayed
|
||||
equations, but it does **not** define ``$...$`` as in-line math
|
||||
|
@ -72,7 +72,7 @@ See the ``config/default.js`` file, or the :ref:`tex2jax configuration
|
|||
options <configure-tex2jax>` page, for additional configuration
|
||||
parameters that you can specify for the `tex2jax` preprocessor,
|
||||
which is the component of MathJax that identifies TeX notation within
|
||||
the page).
|
||||
the page.
|
||||
|
||||
|
||||
TeX and LaTeX in HTML documents
|
||||
|
@ -86,7 +86,7 @@ Also, since the mathematics is initially given as text on the page,
|
|||
you need to be careful that your mathematics doesn't look like HTML
|
||||
tags to the browser (which parses the page before MathJax gets to see
|
||||
it). In particular, that means that you have to be careful about
|
||||
things like less-than and greater-than signs (``<``and ``>``), and
|
||||
things like less-than and greater-than signs (``<`` and ``>``), and
|
||||
ampersands (``&``), which have special meaning to the browsers. For
|
||||
example,
|
||||
|
||||
|
@ -99,10 +99,10 @@ beginning of a tag named ``y`` (even though there is no such tag in
|
|||
HTML). When this happens, the browser will think the tag continues up
|
||||
to the next ``>`` in the document (typically the end of the next
|
||||
actual tag in the HTML file), and you may notice that you are missing
|
||||
part of the text of the document. In the example above, the `` we
|
||||
have ...`` will not be displayed because the browser thinks it is
|
||||
part of the text of the document. In the example above, the "``we
|
||||
have ...``" will not be displayed because the browser thinks it is
|
||||
part of the tag starting at ``<y``. This is one indication you can
|
||||
use to spot this prooblem; it is a common error and should be avoided.
|
||||
use to spot this problem; it is a common error and should be avoided.
|
||||
|
||||
Usually, it is sufficient to simply put spaces around these symbols to
|
||||
cause the browser to avoid them, so
|
||||
|
@ -261,7 +261,7 @@ the paragraph, use
|
|||
}
|
||||
}
|
||||
|
||||
You may also wish to set the font family, as the default is "serif"
|
||||
You may also wish to set the font family, as the default is "serif".
|
||||
|
||||
|
||||
noUndefined
|
||||
|
@ -269,13 +269,13 @@ noUndefined
|
|||
|
||||
The `noUndefined` extension causes undefined control sequences to be
|
||||
shown as their macro names rather than generating error messages. So
|
||||
``$X_{\xxx}$`` would display as an "X" with a subscript consiting of the
|
||||
``$X_{\xxx}$`` would display as an "X" with a subscript consisting of the
|
||||
text ``\xxx`` in red.
|
||||
|
||||
This extension is loaded by all the combined configuration files that
|
||||
include the TeX input processor. To enable the `noUndefined` extension
|
||||
in your own configuration, or to modify its parameters, add something like
|
||||
the following ro your :meth:`MathJax.Hub.Config()` call:
|
||||
the following to your :meth:`MathJax.Hub.Config()` call:
|
||||
|
||||
.. code-block:: javascript
|
||||
|
||||
|
@ -899,7 +899,6 @@ N
|
|||
\nolimits
|
||||
\normalsize
|
||||
\not
|
||||
\notag AMSmath
|
||||
\notag [AMSmath]
|
||||
\notin
|
||||
\nparallel AMSsymbols
|
||||
|
@ -1119,7 +1118,6 @@ T
|
|||
|
||||
.. code-block:: latex
|
||||
|
||||
\tag AMSmath
|
||||
\tag [AMSmath]
|
||||
\tan
|
||||
\tanh
|
||||
|
@ -1273,7 +1271,7 @@ Environments
|
|||
------------
|
||||
|
||||
LaTeX environments of the form ``\begin{XXX} ... \end{XXX}`` are
|
||||
preovided where ``XXX`` is one of the following:
|
||||
provided where ``XXX`` is one of the following:
|
||||
|
||||
.. code-block:: latex
|
||||
|
||||
|
|
|
@ -59,7 +59,7 @@ details.
|
|||
If your page simply loads ``MathJax.js`` and relies on
|
||||
``config/MathJax.js``, then you will need to modify your ``<script>`` tag
|
||||
in order to use MathJax v1.1. This is because MathJax no longer loads a
|
||||
default configuration file; you are required to explicity specify the
|
||||
default configuration file; you are required to explicitly specify the
|
||||
configuration file if you use one. Furthermore, the name of the
|
||||
``config/MathJax.js`` file was a source of confusion, so it has been
|
||||
renamed ``config/default.js`` instead. Thus, if you used
|
||||
|
@ -163,7 +163,7 @@ Of course, you can load any configuration file that you wish, or use a
|
|||
|
||||
The use of ``cdn.mathjax.org`` is governed by its `terms of service
|
||||
<http://www.mathjax.org/download/mathjax-cdn-terms-of-service/>`_, so be
|
||||
sure to read that before linked to the MathJax CDN server.
|
||||
sure to read that before linking to the MathJax CDN server.
|
||||
|
||||
|
||||
Change in default TeX delimiters
|
||||
|
@ -255,5 +255,5 @@ development continues.
|
|||
|
||||
We apologize for the inconvenience of having to switch distributions, but
|
||||
the git-to-svn bridge we tried to implement to keep both copies in synch
|
||||
turned out to be unreliable, and so the SourceForge disrtibution was
|
||||
retired in favor of the GitHub site.
|
||||
turned out to be unreliable, and so the SourceForge distribution was
|
||||
retired in favor of the GitHub site.
|
||||
|
|
Loading…
Reference in New Issue
Block a user