RubyGems - gollum - Versions diffs - 1.1.1 → 1.2.0 - Mend

gollum 1.1.1 → 1.2.0

Potentially problematic release.

This version of gollum might be problematic. Click here for more details.

Files changed (765) hide show

data/lib/gollum/frontend/public/javascript/MathJax/docs/html/options/mml2jax.html ADDED

@@ -0,0 +1,154 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+  <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+    <title>The mml2jax Preprocessor &mdash; MathJax v1.0 documentation</title>
+    <link rel="stylesheet" href="../_static/mj.css" type="text/css" />
+    <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
+    <script type="text/javascript">
+      var DOCUMENTATION_OPTIONS = {
+        URL_ROOT:    '../',
+        VERSION:     '1.0',
+        COLLAPSE_INDEX: false,
+        FILE_SUFFIX: '.html',
+        HAS_SOURCE:  true
+      };
+    </script>
+    <script type="text/javascript" src="../_static/jquery.js"></script>
+    <script type="text/javascript" src="../_static/underscore.js"></script>
+    <script type="text/javascript" src="../_static/doctools.js"></script>
+    <link rel="top" title="MathJax v1.0 documentation" href="../index.html" />
+    <link rel="up" title="Loading and Configuring MathJax" href="../configuration.html" />
+    <link rel="next" title="The jsMath2jax Preprocessor" href="jsMath2jax.html" />
+    <link rel="prev" title="The tex2jax Preprocessor" href="tex2jax.html" />
+  </head>
+  <body>
+    <div class="related">
+      <h3>Navigation</h3>
+      <ul>
+        <li class="right" style="margin-right: 10px">
+          <a href="../genindex.html" title="General Index"
+             accesskey="I">index</a></li>
+        <li class="right" >
+          <a href="jsMath2jax.html" title="The jsMath2jax Preprocessor"
+             accesskey="N">next</a> |</li>
+        <li class="right" >
+          <a href="tex2jax.html" title="The tex2jax Preprocessor"
+             accesskey="P">previous</a> |</li>
+        <li><a href="../index.html">MathJax v1.0 documentation</a> &raquo;</li>
+          <li><a href="../configuration.html" accesskey="U">Loading and Configuring MathJax</a> &raquo;</li>
+      </ul>
+    </div>
+    <div class="document">
+      <div class="documentwrapper">
+        <div class="bodywrapper">
+          <div class="body">
+  <div class="section" id="the-mml2jax-preprocessor">
+<span id="configure-mml2jax"></span><h1>The mml2jax Preprocessor<a class="headerlink" href="#the-mml2jax-preprocessor" title="Permalink to this headline">¶</a></h1>
+<p>The options below control the operation of the <cite>mml2jax</cite> preprocessor
+that is run when you include <tt class="docutils literal"><span class="pre">&quot;mml2jax.js&quot;</span></tt> in the <cite>extensions</cite> array
+of your configuration.  They are listed with their default values.  To
+set any of these options, include a <tt class="docutils literal"><span class="pre">mml2jax</span></tt> section in your
+<tt class="xref py py-meth docutils literal"><span class="pre">MathJax.Hub.Config()</span></tt> call.  For example</p>
+<div class="highlight-javascript"><div class="highlight"><pre><span class="nx">MathJax</span><span class="p">.</span><span class="nx">Hub</span><span class="p">.</span><span class="nx">Config</span><span class="p">({</span>
+  <span class="nx">mml2jax</span><span class="o">:</span> <span class="p">{</span>
+    <span class="nx">preview</span><span class="o">:</span> <span class="s2">&quot;none&quot;</span>
+  <span class="p">}</span>
+<span class="p">});</span>
+</pre></div>
+</div>
+<p>would set the <tt class="docutils literal"><span class="pre">preview</span></tt> parameter to <tt class="docutils literal"><span class="pre">&quot;none&quot;</span></tt>.</p>
+<dl class="describe">
+<dt>
+<tt class="descname">element: null</tt></dt>
+<dd><p>The id name of the element that should be processed by <cite>mml2jax</cite>.
+The default is the whole document.</p>
+</dd></dl>
+<dl class="describe">
+<dt>
+<tt class="descname">preview: &quot;alttext&quot;</tt></dt>
+<dd><p>This controls whether <cite>mml2jax</cite> inserts <tt class="docutils literal"><span class="pre">MathJax_Preview</span></tt> spans
+to make a preview available, and what preview to use, when it
+locates mathematics on the page.  The default is <tt class="docutils literal"><span class="pre">&quot;alttext&quot;</span></tt>,
+which means use the <tt class="docutils literal"><span class="pre">&lt;math&gt;</span></tt> tag&#8217;s <tt class="docutils literal"><span class="pre">alttext</span></tt> attribute as the
+preview (visible until it is processed by MathJax), if the tag has
+one.  Set it to <tt class="docutils literal"><span class="pre">&quot;none&quot;</span></tt> to prevent the previews from being
+inserted (the math will simply disappear until it is typeset).
+Set it to an array containing the description of an HTML snippet
+in order to use the same preview for all equations on the page.</p>
+<p>Examples:</p>
+<div class="highlight-javascript"><div class="highlight"><pre><span class="nx">preview</span><span class="o">:</span> <span class="p">[</span><span class="s2">&quot;[math]&quot;</span><span class="p">],</span>     <span class="c1">//  insert the text &quot;[math]&quot; as the preview</span>
+</pre></div>
+</div>
+<div class="highlight-javascript"><div class="highlight"><pre><span class="nx">preview</span><span class="o">:</span> <span class="p">[[</span><span class="s2">&quot;img&quot;</span><span class="p">,{</span><span class="nx">src</span><span class="o">:</span> <span class="s2">&quot;/images/mypic.jpg&quot;</span><span class="p">}]],</span>  <span class="c1">// insert an image as the preview</span>
+</pre></div>
+</div>
+<p>See the <a class="reference internal" href="../HTML-snippets.html#html-snippets"><em>description of HTML snippets</em></a> for
+details on how to represent HTML code in this way.</p>
+</dd></dl>
+</div>
+          </div>
+        </div>
+      </div>
+      <div class="sphinxsidebar">
+        <div class="sphinxsidebarwrapper">
+  <h4>Previous topic</h4>
+  <p class="topless"><a href="tex2jax.html"
+                        title="previous chapter">The tex2jax Preprocessor</a></p>
+  <h4>Next topic</h4>
+  <p class="topless"><a href="jsMath2jax.html"
+                        title="next chapter">The jsMath2jax Preprocessor</a></p>
+  <h3>This Page</h3>
+  <ul class="this-page-menu">
+    <li><a href="../_sources/options/mml2jax.txt"
+           rel="nofollow">Show Source</a></li>
+  </ul>
+<div id="searchbox" style="display: none">
+  <h3>Quick search</h3>
+    <form class="search" action="../search.html" method="get">
+      <input type="text" name="q" size="18" />
+      <input type="submit" value="Go" />
+      <input type="hidden" name="check_keywords" value="yes" />
+      <input type="hidden" name="area" value="default" />
+    </form>
+    <p class="searchtip" style="font-size: 90%">
+    Enter search terms or a module, class or function name.
+    </p>
+</div>
+<script type="text/javascript">$('#searchbox').show(0);</script>
+        </div>
+      </div>
+      <div class="clearer"></div>
+    </div>
+    <div class="related">
+      <h3>Navigation</h3>
+      <ul>
+        <li class="right" style="margin-right: 10px">
+          <a href="../genindex.html" title="General Index"
+             >index</a></li>
+        <li class="right" >
+          <a href="jsMath2jax.html" title="The jsMath2jax Preprocessor"
+             >next</a> |</li>
+        <li class="right" >
+          <a href="tex2jax.html" title="The tex2jax Preprocessor"
+             >previous</a> |</li>
+        <li><a href="../index.html">MathJax v1.0 documentation</a> &raquo;</li>
+          <li><a href="../configuration.html" >Loading and Configuring MathJax</a> &raquo;</li>
+      </ul>
+    </div>
+    <div class="footer">
+        &copy; Copyright 2010 Design Science.
+      Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0b2.
+    </div>
+  </body>
+</html>

data/lib/gollum/frontend/public/javascript/MathJax/docs/html/options/tex2jax.html ADDED

@@ -0,0 +1,249 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+  <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+    <title>The tex2jax Preprocessor &mdash; MathJax v1.0 documentation</title>
+    <link rel="stylesheet" href="../_static/mj.css" type="text/css" />
+    <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
+    <script type="text/javascript">
+      var DOCUMENTATION_OPTIONS = {
+        URL_ROOT:    '../',
+        VERSION:     '1.0',
+        COLLAPSE_INDEX: false,
+        FILE_SUFFIX: '.html',
+        HAS_SOURCE:  true
+      };
+    </script>
+    <script type="text/javascript" src="../_static/jquery.js"></script>
+    <script type="text/javascript" src="../_static/underscore.js"></script>
+    <script type="text/javascript" src="../_static/doctools.js"></script>
+    <link rel="top" title="MathJax v1.0 documentation" href="../index.html" />
+    <link rel="up" title="Loading and Configuring MathJax" href="../configuration.html" />
+    <link rel="next" title="The mml2jax Preprocessor" href="mml2jax.html" />
+    <link rel="prev" title="The Core Configuration Options" href="hub.html" />
+  </head>
+  <body>
+    <div class="related">
+      <h3>Navigation</h3>
+      <ul>
+        <li class="right" style="margin-right: 10px">
+          <a href="../genindex.html" title="General Index"
+             accesskey="I">index</a></li>
+        <li class="right" >
+          <a href="mml2jax.html" title="The mml2jax Preprocessor"
+             accesskey="N">next</a> |</li>
+        <li class="right" >
+          <a href="hub.html" title="The Core Configuration Options"
+             accesskey="P">previous</a> |</li>
+        <li><a href="../index.html">MathJax v1.0 documentation</a> &raquo;</li>
+          <li><a href="../configuration.html" accesskey="U">Loading and Configuring MathJax</a> &raquo;</li>
+      </ul>
+    </div>
+    <div class="document">
+      <div class="documentwrapper">
+        <div class="bodywrapper">
+          <div class="body">
+  <div class="section" id="the-tex2jax-preprocessor">
+<span id="configure-tex2jax"></span><h1>The tex2jax Preprocessor<a class="headerlink" href="#the-tex2jax-preprocessor" title="Permalink to this headline">¶</a></h1>
+<p>The options below control the operation of the <cite>tex2jax</cite> preprocessor
+that is run when you include <tt class="docutils literal"><span class="pre">&quot;tex2jax.js&quot;</span></tt> in the <cite>extensions</cite> array
+of your configuration.  They are listed with their default values.  To
+set any of these options, include a <tt class="docutils literal"><span class="pre">tex2jax</span></tt> section in your
+<tt class="xref py py-meth docutils literal"><span class="pre">MathJax.Hub.Config()</span></tt> call.  For example</p>
+<div class="highlight-javascript"><div class="highlight"><pre><span class="nx">MathJax</span><span class="p">.</span><span class="nx">Hub</span><span class="p">.</span><span class="nx">Config</span><span class="p">({</span>
+  <span class="nx">tex2jax</span><span class="o">:</span> <span class="p">{</span>
+    <span class="nx">inlineMath</span><span class="o">:</span> <span class="p">[</span> <span class="p">[</span><span class="s1">&#39;$&#39;</span><span class="p">,</span><span class="s1">&#39;$&#39;</span><span class="p">],</span> <span class="p">[</span><span class="s1">&#39;\\(&#39;</span><span class="p">,</span><span class="s1">&#39;\\)&#39;</span><span class="p">]</span> <span class="p">]</span>
+  <span class="p">}</span>
+<span class="p">});</span>
+</pre></div>
+</div>
+<p>would set the <tt class="docutils literal"><span class="pre">inlineMath</span></tt> delimiters for the <cite>tex2jax</cite>
+preprocessor.</p>
+<dl class="describe">
+<dt>
+<tt class="descname">element: null</tt></dt>
+<dd><p>The id name of the element that should be processed by <cite>tex2jax</cite>.
+The default is the whole document.</p>
+</dd></dl>
+<dl class="describe">
+<dt>
+<tt class="descname">inlineMath: [['\(','\)']]</tt></dt>
+<dd><p>Array of pairs of strings that are to be used as in-line math
+delimters.  The first in each pair is the initial delimiter and
+the second is the terminal delimiter.  You can have as many pairs
+as you want.  For example,</p>
+<div class="highlight-javascript"><div class="highlight"><pre><span class="nx">inlineMath</span><span class="o">:</span> <span class="p">[</span> <span class="p">[</span><span class="s1">&#39;$&#39;</span><span class="p">,</span><span class="s1">&#39;$&#39;</span><span class="p">],</span> <span class="p">[</span><span class="s1">&#39;\\(&#39;</span><span class="p">,</span><span class="s1">&#39;\\)&#39;</span><span class="p">]</span> <span class="p">]</span>
+</pre></div>
+</div>
+<p>would cause <cite>tex2jax</cite> to look for <tt class="docutils literal"><span class="pre">$...$</span></tt> and <tt class="docutils literal"><span class="pre">\(...\)</span></tt> as
+delimiters for inline mathematics.  (Note that the single dollar
+signs are not enabled by default because they are used too
+frequently in normal text, so if you want to use them for math
+delimiters, you must specify them explicitly.)</p>
+<p>Note that the delimiters can&#8217;t look like HTML tags (i.e., can&#8217;t
+include the less-than sign), as these would be turned into tags by
+the browser before MathJax has the chance to run.  You can only
+include text, not tags, as your math delimiters.</p>
+</dd></dl>
+<dl class="describe">
+<dt>
+<tt class="descname">displayMath: [ ['$$','$$'], ['\[','\]'] ]</tt></dt>
+<dd><p>Array of pairs of strings that are to be used as delimters for
+displayed equations.  The first in each pair is the initial
+delimiter and the second is the terminal delimiter.  You can have
+as many pairs as you want.</p>
+<p>Note that the delimiters can&#8217;t look like HTML tags (i.e., can&#8217;t
+include the less-than sign), as these would be turned into tags by
+the browser before MathJax has the chance to run.  You can only
+include text, not tags, as your math delimiters.</p>
+</dd></dl>
+<dl class="describe">
+<dt>
+<tt class="descname">processEscapes: false</tt></dt>
+<dd><p>When set to <tt class="docutils literal"><span class="pre">true</span></tt>, you may use <tt class="docutils literal"><span class="pre">\$</span></tt> to represent a literal
+dollar sign, rather than using it as a math delimiter.  When
+<tt class="docutils literal"><span class="pre">false</span></tt>, <tt class="docutils literal"><span class="pre">\$</span></tt> will not be altered, and the dollar sign may be
+considered part of a math delimiter.  Typically this is set to
+<tt class="docutils literal"><span class="pre">true</span></tt> if you enable the <tt class="docutils literal"><span class="pre">$</span> <span class="pre">...</span> <span class="pre">$</span></tt> in-line delimiters, so you
+can type <tt class="docutils literal"><span class="pre">\$</span></tt> and <cite>tex2jax</cite> will convert it to a regular dollar
+sign in the rendered document.</p>
+</dd></dl>
+<dl class="describe">
+<dt>
+<tt class="descname">processEnvironments: true</tt></dt>
+<dd><p>When <tt class="docutils literal"><span class="pre">true</span></tt>, <cite>tex2jax</cite> looks not only for the in-line and
+display math delimters, but also for LaTeX environments
+(<tt class="docutils literal"><span class="pre">\begin{something}...\end{something}</span></tt>) and marks them for
+processing by MathJax.  When <tt class="docutils literal"><span class="pre">false</span></tt>, LaTeX environments will
+not be processed outside of math mode.</p>
+</dd></dl>
+<dl class="describe">
+<dt>
+<tt class="descname">preview: &quot;TeX&quot;</tt></dt>
+<dd><p>This controls whether <cite>tex2jax</cite> inserts <tt class="docutils literal"><span class="pre">MathJax_Preview</span></tt> spans
+to make a preview available, and what preview to use, when it
+locates in-line or display mathematics in the page.  The default
+is <tt class="docutils literal"><span class="pre">&quot;TeX&quot;</span></tt>, which means use the TeX code as the preview (which
+will be visible until it is processed by MathJax).  Set to
+<tt class="docutils literal"><span class="pre">&quot;none&quot;</span></tt> to prevent previews from being inserted (the math
+will simply disappear until it is typeset).  Set to an array
+containing the description of an HTML snippet in order to use the
+same preview for all equations on the page.</p>
+<p>Examples:</p>
+<div class="highlight-javascript"><div class="highlight"><pre><span class="nx">preview</span><span class="o">:</span> <span class="p">[</span><span class="s2">&quot;[math]&quot;</span><span class="p">],</span>     <span class="c1">//  insert the text &quot;[math]&quot; as the preview</span>
+</pre></div>
+</div>
+<div class="highlight-javascript"><div class="highlight"><pre><span class="nx">preview</span><span class="o">:</span> <span class="p">[[</span><span class="s2">&quot;img&quot;</span><span class="p">,{</span><span class="nx">src</span><span class="o">:</span> <span class="s2">&quot;/images/mypic.jpg&quot;</span><span class="p">}]],</span>  <span class="c1">// insert an image as the preview</span>
+</pre></div>
+</div>
+<p>See the <a class="reference internal" href="../HTML-snippets.html#html-snippets"><em>description of HTML snippets</em></a> for
+details on how to represent HTML code in this way.</p>
+</dd></dl>
+<dl class="describe">
+<dt>
+<tt class="descname">skipTags: [&quot;script&quot;,&quot;noscript&quot;,&quot;style&quot;,&quot;textarea&quot;,&quot;pre&quot;,&quot;code&quot;]</tt></dt>
+<dd><p>This array lists the names of the tags whose contents should not
+be processed by <cite>tex2jax</cite> (other than to look for ignore/process
+classes as listed below).  You can add to (or remove from) this
+list to prevent MathJax from processing mathematics in specific
+contexts.</p>
+</dd></dl>
+<dl class="describe">
+<dt>
+<tt class="descname">ignoreClass: &quot;tex2jax_ignore&quot;</tt></dt>
+<dd><p>This is the class name used to mark elements whose contents should
+not be processed by tex2jax (other than to look for the
+<tt class="docutils literal"><span class="pre">processClass</span></tt> pattern below).  Note that this is a regular
+expression, and so you need to be sure to quote any <cite>regexp</cite>
+special characters.  The pattern is automatically preceeded by
+<tt class="docutils literal"><span class="pre">'(^|</span> <span class="pre">)('</span></tt> and followed by <tt class="docutils literal"><span class="pre">')(</span> <span class="pre">|$)'</span></tt>, so your pattern will
+have to match full words in the class name.  Assigning an element
+this class name will prevent <cite>tex2jax</cite> from processing its
+contents.</p>
+</dd></dl>
+<dl class="describe">
+<dt>
+<tt class="descname">processClass: &quot;tex2jax_process&quot;</tt></dt>
+<dd><p>This is the class name used to mark elements whose contents
+<em>should</em> be processed by <cite>tex2jax</cite>.  This is used to turn on
+processing within tags that have been marked as ignored or skipped
+above.  Note that this is a regular expression, and so you need to
+be sure to quote any <cite>regexp</cite> special characters.  The pattern is
+automatically preceeded by <tt class="docutils literal"><span class="pre">'(^|</span> <span class="pre">)('</span></tt> and followed by <tt class="docutils literal"><span class="pre">')(</span>
+<span class="pre">|$)'</span></tt>, so your pattern will have to match full words in the class
+name.  Use this to restart processing within an element that has
+been marked as ignored above.</p>
+</dd></dl>
+</div>
+          </div>
+        </div>
+      </div>
+      <div class="sphinxsidebar">
+        <div class="sphinxsidebarwrapper">
+  <h4>Previous topic</h4>
+  <p class="topless"><a href="hub.html"
+                        title="previous chapter">The Core Configuration Options</a></p>
+  <h4>Next topic</h4>
+  <p class="topless"><a href="mml2jax.html"
+                        title="next chapter">The mml2jax Preprocessor</a></p>
+  <h3>This Page</h3>
+  <ul class="this-page-menu">
+    <li><a href="../_sources/options/tex2jax.txt"
+           rel="nofollow">Show Source</a></li>
+  </ul>
+<div id="searchbox" style="display: none">
+  <h3>Quick search</h3>
+    <form class="search" action="../search.html" method="get">
+      <input type="text" name="q" size="18" />
+      <input type="submit" value="Go" />
+      <input type="hidden" name="check_keywords" value="yes" />
+      <input type="hidden" name="area" value="default" />
+    </form>
+    <p class="searchtip" style="font-size: 90%">
+    Enter search terms or a module, class or function name.
+    </p>
+</div>
+<script type="text/javascript">$('#searchbox').show(0);</script>
+        </div>
+      </div>
+      <div class="clearer"></div>
+    </div>
+    <div class="related">
+      <h3>Navigation</h3>
+      <ul>
+        <li class="right" style="margin-right: 10px">
+          <a href="../genindex.html" title="General Index"
+             >index</a></li>
+        <li class="right" >
+          <a href="mml2jax.html" title="The mml2jax Preprocessor"
+             >next</a> |</li>
+        <li class="right" >
+          <a href="hub.html" title="The Core Configuration Options"
+             >previous</a> |</li>
+        <li><a href="../index.html">MathJax v1.0 documentation</a> &raquo;</li>
+          <li><a href="../configuration.html" >Loading and Configuring MathJax</a> &raquo;</li>
+      </ul>
+    </div>
+    <div class="footer">
+        &copy; Copyright 2010 Design Science.
+      Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0b2.
+    </div>
+  </body>
+</html>

data/lib/gollum/frontend/public/javascript/MathJax/docs/html/output.html ADDED

@@ -0,0 +1,218 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+  <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+    <title>MathJax Output Formats &mdash; MathJax v1.0 documentation</title>
+    <link rel="stylesheet" href="_static/mj.css" type="text/css" />
+    <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+    <script type="text/javascript">
+      var DOCUMENTATION_OPTIONS = {
+        URL_ROOT:    '',
+        VERSION:     '1.0',
+        COLLAPSE_INDEX: false,
+        FILE_SUFFIX: '.html',
+        HAS_SOURCE:  true
+      };
+    </script>
+    <script type="text/javascript" src="_static/jquery.js"></script>
+    <script type="text/javascript" src="_static/underscore.js"></script>
+    <script type="text/javascript" src="_static/doctools.js"></script>
+    <link rel="top" title="MathJax v1.0 documentation" href="index.html" />
+    <link rel="next" title="“Powered by MathJax”" href="badge.html" />
+    <link rel="prev" title="MathJax MathML Support" href="mathml.html" />
+  </head>
+  <body>
+    <div class="related">
+      <h3>Navigation</h3>
+      <ul>
+        <li class="right" style="margin-right: 10px">
+          <a href="genindex.html" title="General Index"
+             accesskey="I">index</a></li>
+        <li class="right" >
+          <a href="badge.html" title="“Powered by MathJax”"
+             accesskey="N">next</a> |</li>
+        <li class="right" >
+          <a href="mathml.html" title="MathJax MathML Support"
+             accesskey="P">previous</a> |</li>
+        <li><a href="index.html">MathJax v1.0 documentation</a> &raquo;</li>
+      </ul>
+    </div>
+    <div class="document">
+      <div class="documentwrapper">
+        <div class="bodywrapper">
+          <div class="body">
+  <div class="section" id="mathjax-output-formats">
+<span id="output-formats"></span><h1>MathJax Output Formats<a class="headerlink" href="#mathjax-output-formats" title="Permalink to this headline">¶</a></h1>
+<p>Currently, MathJax can render math in two ways:</p>
+<ul class="simple">
+<li>Using HTML-with-CSS to lay out the mathematics, or</li>
+<li>Using a browser&#8217;s native MathML support.</li>
+</ul>
+<p>These are implemented by the <cite>HTML-CSS</cite> and <cite>NativeMML</cite> output
+processors.  You select which one you want to use by including either
+<tt class="docutils literal"><span class="pre">&quot;output/HTML-CSS&quot;</span></tt> or <tt class="docutils literal"><span class="pre">&quot;output/NativeMML&quot;</span></tt> in the <cite>jax</cite> array of
+your MathJax configuration.  For example</p>
+<div class="highlight-javascript"><div class="highlight"><pre><span class="nx">jax</span><span class="o">:</span> <span class="p">[</span><span class="s2">&quot;input/TeX&quot;</span><span class="p">,</span><span class="s2">&quot;output/HTML-CSS&quot;</span><span class="p">]</span>
+</pre></div>
+</div>
+<p>would specify TeX input and HTML-with-CSS output for the mathematics
+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&#8217;s primary output mode.  It&#8217;s major
+advantage is its quality and consistency; it&#8217;s drawback is that it is
+slower that 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 &#8220;IE8
+standards mode&#8221; is an order of magnitude slower than any other browser
+when processing math through the HTML-CSS output processor; see
+<a class="reference internal" href="#html-css-with-ie8"><em>HTML-CSS with IE8</em></a> below for some strategies
+to deal with this.)</p>
+<p>The NativeMML output processor uses the browser&#8217;s internal MathML support (if
+any) to render the mathematics.  Currently, Firefox has native support
+for MathML, and IE has the <a class="reference external" href="http://www.dessci.com/en/products/mathplayer/">MathPlayer plugin</a> for rendering
+MathML.  Opera has some built-in support for MathML that works well
+with simple equations, but fails with more complex formulas, so we
+don&#8217;t recommend using the NativeMML output processor with Opera.  Safari,
+Chrome, Konqueror, and most other browsers don&#8217;t support MathML
+natively.</p>
+<p>The advantage of the NativeMML output Processor is its speed, since
+native MathML support is much faster than using complicated HTML and
+CSS to lay out mathematics via an interpreted language like JavaScript
+(as the HTML-CSS output processor does).  The disadvantage is that you
+are dependent on the browser&#8217;s MathML implementation for your
+rendering, and these vary in quality of output and completeness of
+implementation.  MathJax may rely on features that are not available
+in some renderers (for example, Firefox&#8217;s MathML support does not
+implement some of the named widths, such as
+<tt class="docutils literal"><span class="pre">negativethinmathspace</span></tt>).  The results using the NativeMML output
+processor may have spacing or other rendering problems that are
+outside of MathJax&#8217;s control.</p>
+<div class="section" id="automatic-selection-of-the-output-processor">
+<h2>Automatic Selection of the Output Processor<a class="headerlink" href="#automatic-selection-of-the-output-processor" title="Permalink to this headline">¶</a></h2>
+<p>Since not all browsers support MathML natively, it would be unwise to
+choose the NativeMML output processor unless you are sure of your
+audience&#8217;s browser capabilities.  MathJax can help with that, however,
+since there is a special configuration file 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">&quot;MMLorHTML.js&quot;</span></tt> to your configurations <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&#8217;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">&quot;MMLorHTML.js&quot;</span><span class="p">],</span>
+<span class="nx">jax</span><span class="o">:</span> <span class="p">[</span><span class="s2">&quot;input/TeX&quot;</span><span class="p">]</span>
+</pre></div>
+</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/MathJax.js</span></tt> file or the
+<a class="reference internal" href="configuration.html#configuration"><em>Configuring MathJax</em></a> section for futher
+details.</p>
+<p>MathJax produces MathML that models the underlying mathematics as best
+it can, rather than using complicated hacks to improve output for a
+particular MathML implementation.  When you make the choice to use the
+NativeMML output processor, you are making a trade-off: gaining speed
+at the expense of quality and reliability, a decision that should not
+be taken lightly.  Note, however, that a user can employ the MathJax
+contectual menu to select the other other renderer if he or she
+wishes.</p>
+</div>
+<div class="section" id="html-css-with-ie8">
+<span id="id1"></span><h2>HTML-CSS with IE8<a class="headerlink" href="#html-css-with-ie8" title="Permalink to this headline">¶</a></h2>
+<p>Internet Explorer 8 has at least eight different rendering modes in
+which can operate, and that are triggered by the <cite>DOCTYPE</cite> of the
+document being viewed.  It&#8217;s &#8220;quirks&#8221; mode is its fasted mode, and its
+&#8220;IE8 standards&#8221; mode is its slowest.  This is the mode triggered by
+strict HTML document types, and since most modern content management
+systems now include a <cite>DOCTYPE</cite> that activates &#8220;standards&#8221; mode, IE8
+will operate in its slowest manner.  This is particularly apparent
+when MathJax is used, since IE8 in standards mode runs 20 to 30 times
+slower than its does in its IE7 emulation mode, and 60 times slower
+than in quirks mode.</p>
+<p>Most users find this speed reduction unacceptable when there is much
+mathematics on the page.  To overcome this problem, you may wish to
+tell IE8 to use its IE7 emulation mode rather than its IE8 standards
+mode.  You can accomplish this by including the line</p>
+<div class="highlight-html"><div class="highlight"><pre><span class="nt">&lt;meta</span> <span class="na">http-equiv=</span><span class="s">&quot;X-UA-Compatible&quot;</span> <span class="na">content=</span><span class="s">&quot;IE=EmulateIE7&quot;</span><span class="nt">&gt;</span>
+</pre></div>
+</div>
+<p>at the top of the <tt class="docutils literal"><span class="pre">&lt;head&gt;</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 Internext Explorer
+8.  Note that this line must come at the beginning of the <tt class="docutils literal"><span class="pre">&lt;head&gt;</span></tt>,
+before any stylesheets or other content are loaded.</p>
+<p>Altertnatively, 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>
+</div>
+</div>
+          </div>
+        </div>
+      </div>
+      <div class="sphinxsidebar">
+        <div class="sphinxsidebarwrapper">
+  <h3><a href="index.html">Table Of Contents</a></h3>
+  <ul>
+<li><a class="reference internal" href="#">MathJax Output Formats</a><ul>
+<li><a class="reference internal" href="#automatic-selection-of-the-output-processor">Automatic Selection of the Output Processor</a></li>
+<li><a class="reference internal" href="#html-css-with-ie8">HTML-CSS with IE8</a></li>
+</ul>
+</li>
+</ul>
+  <h4>Previous topic</h4>
+  <p class="topless"><a href="mathml.html"
+                        title="previous chapter">MathJax MathML Support</a></p>
+  <h4>Next topic</h4>
+  <p class="topless"><a href="badge.html"
+                        title="next chapter">&#8220;Powered by MathJax&#8221;</a></p>
+  <h3>This Page</h3>
+  <ul class="this-page-menu">
+    <li><a href="_sources/output.txt"
+           rel="nofollow">Show Source</a></li>
+  </ul>
+<div id="searchbox" style="display: none">
+  <h3>Quick search</h3>
+    <form class="search" action="search.html" method="get">
+      <input type="text" name="q" size="18" />
+      <input type="submit" value="Go" />
+      <input type="hidden" name="check_keywords" value="yes" />
+      <input type="hidden" name="area" value="default" />
+    </form>
+    <p class="searchtip" style="font-size: 90%">
+    Enter search terms or a module, class or function name.
+    </p>
+</div>
+<script type="text/javascript">$('#searchbox').show(0);</script>
+        </div>
+      </div>
+      <div class="clearer"></div>
+    </div>
+    <div class="related">
+      <h3>Navigation</h3>
+      <ul>
+        <li class="right" style="margin-right: 10px">
+          <a href="genindex.html" title="General Index"
+             >index</a></li>
+        <li class="right" >
+          <a href="badge.html" title="“Powered by MathJax”"
+             >next</a> |</li>
+        <li class="right" >
+          <a href="mathml.html" title="MathJax MathML Support"
+             >previous</a> |</li>
+        <li><a href="index.html">MathJax v1.0 documentation</a> &raquo;</li>
+      </ul>
+    </div>
+    <div class="footer">
+        &copy; Copyright 2010 Design Science.
+      Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0b2.
+    </div>
+  </body>
+</html>