/usr/share/doc/libjs-mathjax-doc/html/mathml.html is in libjs-mathjax-doc 2.7+20171212-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 | <!DOCTYPE html>
<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>MathJax MathML Support — MathJax 2.7 documentation</title>
<link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
<link rel="index" title="Index"
href="genindex.html"/>
<link rel="search" title="Search" href="search.html"/>
<link rel="top" title="MathJax 2.7 documentation" href="index.html"/>
<link rel="next" title="MathJax AsciiMath Support" href="asciimath.html"/>
<link rel="prev" title="MathJax TeX and LaTeX Support" href="tex.html"/>
<script src="_static/js/modernizr.min.js"></script>
</head>
<body class="wy-body-for-nav" role="document">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-scroll">
<div class="wy-side-nav-search">
<a href="index.html" class="icon icon-home"> MathJax
</a>
<div class="version">
2.7
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="search.html" method="get">
<input type="text" name="q" placeholder="Search docs" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div>
<div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
<p class="caption"><span class="caption-text">Basic Usage</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="mathjax.html">What is MathJax?</a></li>
<li class="toctree-l1"><a class="reference internal" href="start.html">Getting Started with MathJax</a></li>
<li class="toctree-l1"><a class="reference internal" href="installation.html">Installing and Testing MathJax</a></li>
<li class="toctree-l1"><a class="reference internal" href="configuration.html">Loading and Configuring MathJax</a></li>
<li class="toctree-l1"><a class="reference internal" href="config-files.html">Combined MathJax Configurations</a></li>
</ul>
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="tex.html">MathJax TeX and LaTeX Support</a></li>
<li class="toctree-l1 current"><a class="current reference internal" href="#">MathJax MathML Support</a><ul>
<li class="toctree-l2"><a class="reference internal" href="#mathml-in-html-pages">MathML in HTML pages</a></li>
<li class="toctree-l2"><a class="reference internal" href="#supported-mathml-commands">Supported MathML commands</a></li>
<li class="toctree-l2"><a class="reference internal" href="#content-mathml">Content MathML</a></li>
<li class="toctree-l2"><a class="reference internal" href="#experimental-mml3-extension">Experimental mml3 extension</a></li>
<li class="toctree-l2"><a class="reference internal" href="#semantics-and-annotations">Semantics and Annotations</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="asciimath.html">MathJax AsciiMath Support</a></li>
<li class="toctree-l1"><a class="reference internal" href="output.html">MathJax Output Formats</a></li>
<li class="toctree-l1"><a class="reference internal" href="font-support.html">MathJax Font Support</a></li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="localization.html">MathJax Localization</a></li>
<li class="toctree-l1"><a class="reference internal" href="safe-mode.html">MathJax Safe-mode</a></li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="community.html">The MathJax Community</a></li>
</ul>
<p class="caption"><span class="caption-text">Configuration options</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="options/index.html">Configuration options</a></li>
</ul>
<p class="caption"><span class="caption-text">Advanced topics</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="advanced/model.html">The MathJax Processing Model</a></li>
<li class="toctree-l1"><a class="reference internal" href="advanced/startup.html">The MathJax Startup Sequence</a></li>
<li class="toctree-l1"><a class="reference internal" href="advanced/synchronize.html">Synchronizing Your Code with MathJax</a></li>
<li class="toctree-l1"><a class="reference internal" href="advanced/dynamic.html">Loading MathJax Dynamically</a></li>
<li class="toctree-l1"><a class="reference internal" href="advanced/typeset.html">Modifying Math on the Page</a></li>
<li class="toctree-l1"><a class="reference internal" href="advanced/toMathML.html">Obtaining the MathML for an Expression</a></li>
<li class="toctree-l1"><a class="reference internal" href="advanced/extension-writing.html">Writing MathJax Extensions</a></li>
<li class="toctree-l1"><a class="reference internal" href="advanced/debugging-tips.html">Debugging Tips</a></li>
<li class="toctree-l1"><a class="reference internal" href="advanced/mathjax-node.html">MathJax on NodeJS</a></li>
</ul>
<p class="caption"><span class="caption-text">The MathJax API</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="api/index.html">Details of the MathJax API</a></li>
</ul>
<p class="caption"><span class="caption-text">Miscellanea</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="misc/accessibility-features.html">Accessibility features</a></li>
<li class="toctree-l1"><a class="reference internal" href="misc/browser-compatibility.html">Browser Compatibility</a></li>
<li class="toctree-l1"><a class="reference internal" href="misc/epub.html">EPUB3 Reading Systems</a></li>
<li class="toctree-l1"><a class="reference internal" href="misc/badges.html">MathJax Badges and Logo</a></li>
<li class="toctree-l1"><a class="reference internal" href="misc/articles.html">Articles and Presentations</a></li>
<li class="toctree-l1"><a class="reference internal" href="misc/platforms.html">Using MathJax in Web Platforms</a></li>
<li class="toctree-l1"><a class="reference internal" href="misc/faq.html">MathJax FAQ</a></li>
<li class="toctree-l1"><a class="reference internal" href="misc/mathjax-in-use.html">MathJax in Use</a></li>
</ul>
<p class="caption"><span class="caption-text">Upgrading MathJax</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="upgrading/index.html">Upgrading MathJax</a></li>
</ul>
<p class="caption"><span class="caption-text">Reference Pages</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="reference/HTML-snippets.html">HTML snippets</a></li>
<li class="toctree-l1"><a class="reference internal" href="reference/CSS-styles.html">CSS style objects</a></li>
<li class="toctree-l1"><a class="reference internal" href="reference/localization-strings.html">Localization strings</a></li>
<li class="toctree-l1"><a class="reference internal" href="reference/glossary.html">Glossary</a></li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
<nav class="wy-nav-top" role="navigation" aria-label="top navigation">
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="index.html">MathJax</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content">
<div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
<li><a href="index.html">Docs</a> »</li>
<li>MathJax MathML Support</li>
<li class="wy-breadcrumbs-aside">
<a href="_sources/mathml.rst.txt" rel="nofollow"> View page source</a>
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<div class="section" id="mathjax-mathml-support">
<span id="mathml-support"></span><h1>MathJax MathML Support<a class="headerlink" href="#mathjax-mathml-support" title="Permalink to this headline">¶</a></h1>
<p>The support for <a class="reference internal" href="reference/glossary.html#term-mathml"><span class="xref std std-term">MathML</span></a> in MathJax comes in three parts: the
<cite>mml2jax</cite> preprocessor, the <cite>MathML</cite> input processor, and the <cite>NativeMML</cite>
output processor. The first of these looks for <code class="docutils literal"><span class="pre"><math></span></code> tags within
your document and marks them for later processing by MathJax. The
second converts the MathML to the internal format used by MathJax, and
the third turns the internal format into MathML within the page so
that it can be displayed by the browser’s native MathML support.</p>
<p>Because of MathJax’s modular design, you do not need to use all three
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> 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
you so that MathML is used in those browsers that support it well
enough, while HTML-CSS is used for those that don’t. See the
<a class="reference internal" href="config-files.html#common-configurations"><span class="std std-ref">combined configurations</span></a> section for
details and examples.</p>
<p>Of course it is also possible to use all three components together.
It may seem strange to go through an internal format just to return to
MathML in the end, but this is actually what makes it possible to view
MathML within an HTML4 page (rather than an XHTML page), in particular in older
browsers, without the complications of handling special MIME-types for the
document, or any of the other setup issues that make using native MathML
difficult.</p>
<p>MathJax handles the setup and properly marks the
mathematics so that the browser will render it as MathML. In
addition, MathJax provides its contextual menu for the MathML, which
lets the user zoom the mathematics for easier reading, get and copy
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 preprocessor, you should not use
named MathML entities, but rather use numeric entities like
<code class="docutils literal"><span class="pre">&#x221A;</span></code> or unicode characters embedded in the page itself. The
reason is that entities are replaced by the browser before MathJax
runs, and some browsers report errors for unknown entities. For
browsers that are not MathML-aware, that will cause errors to be
displayed for the MathML entities. While that might not occur in the
browser you are using to compose your pages, it can happen with other
browsers, so you should avoid the named entities whenever possible.
If you must use named entities, you may need to declare them in the
<cite>DOCTYPE</cite> declaration by hand.</p>
<p>When you use MathML in an HTML4 document rather than an XHTML one
(MathJax will work with both), you should not use the “self-closing”
form for tags with no content, but should use separate open and close
tags. That is, use</p>
<div class="highlight-html"><div class="highlight"><pre><span></span><span class="p"><</span><span class="nt">mspace</span> <span class="na">width</span><span class="o">=</span><span class="s">"thinmathspace"</span><span class="p">></</span><span class="nt">mspace</span><span class="p">></span>
</pre></div>
</div>
<p>rather than <code class="docutils literal"><span class="pre"><mspace</span> <span class="pre">width="thinmathspace"</span> <span class="pre">/></span></code>. This is because HTML
(prior to HTML5) does not have self-closing tags, and some browsers
will get the nesting of tags wrong if you attempt to use them. For
example, with <code class="docutils literal"><span class="pre"><mspace</span> <span class="pre">width="1em"</span> <span class="pre">/></span></code>, since there is no closing
tag, the rest of the mathematics will become the content of the
<code class="docutils literal"><span class="pre"><mspace></span></code> tag; but since <code class="docutils literal"><span class="pre"><mspace></span></code> should have no content, the
rest of the mathematics will not be displayed. This is a common error
that should be avoided. Modern browsers that support HTML5 should be
able to handle self-closing tags, but older browsers have problems
with them, so if you want your mathematics to be visible to the widest
audience, do not use the self-closing form in HTML documents.</p>
</div>
<div class="section" id="supported-mathml-commands">
<h2>Supported MathML commands<a class="headerlink" href="#supported-mathml-commands" title="Permalink to this headline">¶</a></h2>
<p>MathJax supports the <a class="reference external" href="http://www.w3.org/TR/MathML3/">MathML3.0</a>
mathematics tags, with some limitations. The MathML
support is still under active development, so some tags are not yet
implemented, and some features are not fully developed, but are
coming.</p>
<p>The deficiencies include:</p>
<ul class="simple">
<li>No support for alignment groups in tables.</li>
<li>Not all attributes are supported for tables. E.g., <code class="docutils literal"><span class="pre">columnspan</span></code>
and <code class="docutils literal"><span class="pre">rowspan</span></code> are not implemented yet.</li>
<li>Experimental support for the elementary math tags: <code class="docutils literal"><span class="pre">mstack</span></code>, <code class="docutils literal"><span class="pre">mlongdiv</span></code>,
<code class="docutils literal"><span class="pre">msgroup</span></code>, <code class="docutils literal"><span class="pre">msrow</span></code>, <code class="docutils literal"><span class="pre">mscarries</span></code>, and <code class="docutils literal"><span class="pre">mscarry</span></code>. (Via the <code class="docutils literal"><span class="pre">mml3</span></code> extension, see below.)</li>
<li>Experimental support for bidirectional mathematics. (Via the <code class="docutils literal"><span class="pre">mml3</span></code> extension, see below.)</li>
</ul>
<p>See the <a class="reference external" href="http://www.w3.org/Math/testsuite/results/tests.html">results of the MathML3.0 test suite</a> for details.</p>
</div>
<div class="section" id="content-mathml">
<span id="id1"></span><h2>Content MathML<a class="headerlink" href="#content-mathml" title="Permalink to this headline">¶</a></h2>
<p>To use Content MathML in your documents, simply include
<code class="docutils literal"><span class="pre">"content-mathml.js"</span></code> in the <code class="docutils literal"><span class="pre">extensions</span></code> array of your MathML
configuration block. For example</p>
<div class="highlight-html"><div class="highlight"><pre><span></span><span class="p"><</span><span class="nt">script</span> <span class="na">type</span><span class="o">=</span><span class="s">"text/x-mathjax-config"</span><span class="p">></span>
<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">MathML</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">"content-mathml.js"</span><span class="p">]</span>
<span class="p">}</span>
<span class="p">});</span>
<span class="p"></</span><span class="nt">script</span><span class="p">></span>
</pre></div>
</div>
<p>Note that this script tag must come <em>before</em> the script that loads
<code class="docutils literal"><span class="pre">MathJax.js</span></code> itself.</p>
<p>For more information, see <a class="reference internal" href="options/extensions/Content-MathML.html"><span class="doc">The Content MathML extension</span></a>.</p>
</div>
<div class="section" id="experimental-mml3-extension">
<span id="experimental-mathml"></span><h2>Experimental mml3 extension<a class="headerlink" href="#experimental-mml3-extension" title="Permalink to this headline">¶</a></h2>
<p>To activate experimental features in your documents, simply include
<code class="docutils literal"><span class="pre">"mml3.js"</span></code> in the <code class="docutils literal"><span class="pre">extensions</span></code> array of your MathML
configuration block. For example</p>
<div class="highlight-html"><div class="highlight"><pre><span></span><span class="p"><</span><span class="nt">script</span> <span class="na">type</span><span class="o">=</span><span class="s">"text/x-mathjax-config"</span><span class="p">></span>
<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">MathML</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">"mml3.js"</span><span class="p">]</span>
<span class="p">}</span>
<span class="p">});</span>
<span class="p"></</span><span class="nt">script</span><span class="p">></span>
</pre></div>
</div>
<p>Note that this script tag must come <em>before</em> the script that loads
<code class="docutils literal"><span class="pre">MathJax.js</span></code> itself.</p>
<p>For more information, see <a class="reference internal" href="options/extensions/MML3.html"><span class="doc">The MML3 extension</span></a>.</p>
</div>
<div class="section" id="semantics-and-annotations">
<h2>Semantics and Annotations<a class="headerlink" href="#semantics-and-annotations" title="Permalink to this headline">¶</a></h2>
<p>Starting with MathJax version 2.3, some popular annotation formats like TeX,
Maple, or Content MathML that are often included in the MathML source via the
<code class="docutils literal"><span class="pre">semantics</span></code> element are accessible from the <code class="docutils literal"><span class="pre">"Show</span> <span class="pre">Math</span> <span class="pre">As"</span></code> menu.
See the <a class="reference external" href="http://www.w3.org/TR/MathML/chapter5.html#mixing.semantic.annotations">MathML Annotation Framework</a> and
the <a class="reference internal" href="options/other/MathMenu.html#configure-mathmenu"><span class="std std-ref">The MathMenu extension</span></a> documentation for details.</p>
</div>
</div>
</div>
<div class="articleComments">
</div>
</div>
<footer>
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
<a href="asciimath.html" class="btn btn-neutral float-right" title="MathJax AsciiMath Support" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right"></span></a>
<a href="tex.html" class="btn btn-neutral" title="MathJax TeX and LaTeX Support" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> Previous</a>
</div>
<hr/>
<div role="contentinfo">
<p>
© Copyright 2017 The MathJax Consortium.
</p>
</div>
Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'./',
VERSION:'2.7',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</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>
<script type="text/javascript" src="_static/js/theme.js"></script>
<script type="text/javascript">
jQuery(function () {
SphinxRtdTheme.StickyNav.enable();
});
</script>
</body>
</html>
|