MathML Input Processor Options
The options below control the operation of the MathML input
processor that is run when you include
'input/mathml'
in the load
array of the loader
block of
your MathJax configuration, or if you load a combined component that
includes the MathML input jax. They are listed with their default
values. To set any of these options, include an mml
section in
your MathJax
global object.
The Configuration Block
MathJax = {
mml: {
parseAs: 'html', // or 'xml'
forceReparse: false, // true to serialize and re-parse all MathML
parseError: function (node) { // function to process parsing errors
this.error(this.adaptor.textContent(node).replace(/\n.*/g, ''));
}
}
};
Option Descriptions
- parseAs: 'html'
Specifies how MathML strings should be parsed: as XML or as HTML. When set to
'xml'
, the browser’s XML parser is used, which is more strict about format (e.g., matching end tags) than the HTML parser, which is the default. In node application (where theliteDOM
is used), these both use the same parser, which is not very strict.
- forceReparse: false
Specifies whether MathJax will serialize and re-parse MathML found in the document. This can be useful if you want to do XML parsing of the MathML from an HTML document.
- parseError: (node) => {...}
Specifies a function to be called when there is a parsing error in the MathML (usually only happens with XML parsing). The
node
is a DOM node containing the error text. Your function can process that in any way it sees fit. The default is to call the MathML input processor’s error function with the text of the error (which will create anmerror
node with the error message). Note that this function runs withthis
being the MathML input processor object.
Developer Options
In addition to the options listed above, low-level options intended for developers include the following:
- FindMathML: null
The
FindMathML
object instance that will override the default one. This allows you to create a subclass ofFindMathML
and pass that to the MathML input jax. Anull
value means use the defaultFindMathML
class and make a new instance of that.
- MathMLCompile: null
The
MathMLCompile
object instance that will override the default one. This allows you to create a subclass ofMathMLCompile
and pass that to the MathML input jax. Anull
value means use the defaultMathMLCompile
class and make a new instance of that.