MMLorHTML.rst

The MMLorHTML configuration options

The options below control the operation of the MMLorHTML configuration file that is run when you include "MMLorHTML.js" in the config array of your configuration, or when you use one of the combined configuration files that ends with _HTMLorMML. They are listed with their default values. To set any of these options, include a MMLorHTML section in your :meth:`MathJax.Hub.Config()` call. For example

MathJax.Hub.Config({
  MMLorHTML: {
    prefer: {
      Opera: "MML"
    }
  }
});

would set the prefer option so that the Opera browser would prefer MathML to HTML-CSS output (while leaving the settings for other browsers unchanged).

Note that if you use the MMLorHTML.js configuration file, you should not specify an output processor in the jax array of your configuration; MMLorHTML will fill that in for you.

.. describe:: prefer: {
                MSIE: "MML",
                Firefox: "HTML",
                Safari: "HTML",
                Chrome: "HTML",
                Opera: "HTML",
                other: "HTML"
              }

   This lets you set the preferred renderer on a browser-by-browser
   basis.  You set the browser to either ``"MML"`` or ``"HTML"``
   depending on whether you want to use the `NativeMML` or `HTML-CSS`
   output processor.  Note that although Opera and Safari do process some MathML
   natively, their support is not sufficient to handle the more
   complicated output generated by MathJax, so their settings are
   ``"HTML"`` by default.  Although Firefox does support a large
   subset of MathJax, it does not implement all the features needed by
   MathJax, and so it is also set to ``"HTML"`` by default (this is
   new in v2.0).

   Note that users can still use the MathJax contextual menu to select
   a different renderer after the default one has been chosen by
   ``MMLorHTML.js``.