MathJax Documentation¶

The Core Configuration Options¶

The options below control the MathJax Hub, and so determine the code behavior of MathJax. They are given with their default values.

jax: ["input/TeX","output/HTML-CSS"]

A comma-separated list of input and output jax to initialize at startup. Their main code is loaded only when they are actually used, so it is not inefficient to include jax that may not actually be used on the page. These are found in the MathJax/jax directory.

extensions: []

A comma-separated list of extensions to load at startup. The default directory is MathJax/extensions. The tex2jax and mml2jax preprocessors can be listed here, as well as a number of TeX-specific extensions (see the TeX and LaTeX input section of the Getting Started document for more details). There is also a FontWarnings extension that you can use to inform your user that mathematics fonts are available that they can download to improve their experience of your site.

config: []

A comma-separated list of configuration files to load when MathJax starts up, e.g., to define local macros, etc., and there is a sample config file named config/local/local.js. The default directory is the MathJax/config directory. The MMLorHTML.js configuration is the only other predefined configuration file.

styleSheets: []

A comma-separated list of CSS stylesheet files to be loaded when MathJax starts up. The default directory is the MathJax/config directory.

styles: {}

CSS selector: rules; styles to be defined dynamically at startup time.

preJax: null and postJax: null

Patterns to remove from before and after math script tags. If you are not using one of the preprocessors, you need to insert something extra into your HTML file in order to avoid a bug in Internet Explorer. IE removes spaces from the DOM that it thinks are redundent, and since a <script> tag usually doesn’t add content to the page, if there is a space before and after a MathJax <script> tag, IE will remove the first space. When MathJax inserts the typeset mathematics, this means there will be no space before it and the preceeding text. In order to avoid this, you should include some “guard characters” before or after the math SCRIPT tag; define the patterns you want to use below. Note that these are used as regular expressions, so you will need to quote special characters. Furthermore, since they are javascript strings, you must quote javascript special characters as well. So to obtain a backslash, you must use \\ (doubled for javascript). For example, "\\[" represents the pattern \[ in the regular expression. That means that if you want an actual backslash in your guard characters, you need to use "\\\\" in order to get \\ in the regular expression, and \ in the actual text. If both preJax and postJax are defined, both must be present in order to be removed.

See also the preRemoveClass comments below.

Examples:

preJax: "\\\\\\\\\" makes a double backslash the preJax text

preJax: "\\[\\[", postJax: "\\]\\]" makes it so jax scripts must be enclosed in double brackets.

preRemoveClass: "MathJax_Preview"

The CSS class for a math preview to be removed preceeding a MathJax SCRIPT tag. If the tag just before the MathJax <script> tag is of this class, its contents are removed when MathJax processes the <script> tag. This allows you to include a math preview in a form that will be displayed prior to MathJax performing its typesetting. It also avoids the Internet Explorer space-removal bug, and can be used in place of preJax and postJax if that is more convenient.

For example

<span class="MathJax_Preview">[math]</span><script  type="math/tex">...</script>

would display “[math]” in place of the math until MathJax is able to typeset it.

See also the preJax and postJax comments above.

showProcessingMessages: true

This value controls whether the Processing Math: nn% message are displayed in the lower left-hand corner. Set to false to prevent those messages (though file loading and other messages will still be shown).

messageStyle: "normal"

This value controls the verbosity of the messages in the lower left-hand corner. Set it to "none" to eliminate all messages, or set it to "simple" to show “Loading...” and “Processing...” rather than showing the full file name or the percentage of the mathematics processed.

displayAlign: "center" and displayIndent: "0em"

These two parameters control the alignment and shifting of displayed equations. The first can be "left", "center", or "right", and determines the alignment of displayed equations. When the alignment is not "center", the second determines an indentation from the left or right side for the displayed equations.

delayStartupUntil: "none"

Normally MathJax will perform its starup commands (loading of configuration, styles, jax, and so on) as soon as it can. If you expect to be doing additional configuration on the page, however, you may want to have it wait until the page’s onload hander is called. If so, set this to "onload".

skipStartupTypeset: false

Normally MathJax will typeset the mathematics on the page as soon as the page is loaded. If you want to delay that process, in which case you will need to call MathJax.Hub.Typeset() yourself by hand, set this value to true.

menuSettings: { ... }

This block contains settings for the mathematics contextual menu that act as the defaults for the user’s settings in that menu. The possible values are:

zoom: "none"

This indicates when typeset mathematics should be zoomed. It can be set to "None", "Hover", "Click", or "Double-Click" to set the zoom trigger.

CTRL: false, ALT: false, CMD: false, Shift: false

These values indicate which keys must be pressed in order for math zoom to be triggered. For example, if CTRL is set to true and zoom is "Click", then math will be zoomed only when the user control-clicks on mathematics (i.e., clicks while holding down the CTRL key). If more than one is true, then all the indicated keys must be pressed for the zoom to occur.

zscale: "200%"

This is the zoom scaling factor, and it can be set to any of the values available in the Zoom Factor menu of the Settings submenu of the contextual menu.

context: "MathJax"

This controls what contextual menu will be presented when a right click (on a PC) or CTRL-click (on the Mac) occurs over a typeset equation. When set to "MathJax", the MathJax contextual menu will appear; when set to "Browser", the browser’s contextual menu will be used. For example, in Internet Explorer with the MathPlayer plugin, if this is set to "Browser", you will get the MathPlayer contextual menu rather than the MathJax menu.

There are also settings for format, renderer, and font, but these are maintained by MathJax and should not be set by the page author.

errorSettings: { ... }

This block contains settings that control how MathJax responds to unexpected errors while processing mathematical equations. Rather than simply crash, MathJax can report an error and go on. The options you can set include:

message: ["[Math Processing Error"]]

This is an HTML snippet that will be inserted at the location of the mathematics for any formula that causes MathJax to produce an internal error (i.e., an error in the MathJax code itself). See the description of HTML snippets for details on how to represent HTML code in this way.

style: {color:"#CC0000", "font-style":"italic"}

This is the CSS style description to use for the error messages produced by internal MathJax errors. See the section on CSS style objects for details on how these are specified in JavaScript.

The tex2jax Preprocessor¶

The options below control the operation of the tex2jax preprocessor that is run when you include "tex2jax.js" in the extensions array of your configuration. They are listed with their default values. To set any of these options, include a tex2jax section in your MathJax.Hub.Config() call. For example

MathJax.Hub.Config({
  tex2jax: {
    inlineMath: [ ['$','$'], ['\\(','\\)'] ]
  }
});

would set the inlineMath delimiters for the tex2jax preprocessor.

element: null

The id name of the element that should be processed by tex2jax. The default is the whole document.

inlineMath: [['\(','\)']]

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,

inlineMath: [ ['$','$'], ['\\(','\\)'] ]

would cause tex2jax to look for $...$ and \(...\) 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.)

Note that the delimiters can’t look like HTML tags (i.e., can’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.

displayMath: [ ['$$','$$'], ['\[','\]'] ]

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.

Note that the delimiters can’t look like HTML tags (i.e., can’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.

processEscapes: false

When set to true, you may use \$ to represent a literal dollar sign, rather than using it as a math delimiter. When false, \$ will not be altered, and the dollar sign may be considered part of a math delimiter. Typically this is set to true if you enable the $ ... $ in-line delimiters, so you can type \$ and tex2jax will convert it to a regular dollar sign in the rendered document.

processEnvironments: true

When true, tex2jax looks not only for the in-line and display math delimters, but also for LaTeX environments (\begin{something}...\end{something}) and marks them for processing by MathJax. When false, LaTeX environments will not be processed outside of math mode.

preview: "TeX"

This controls whether tex2jax inserts MathJax_Preview 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 "TeX", which means use the TeX code as the preview (which will be visible until it is processed by MathJax). Set to "none" 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.

Examples:

preview: ["[math]"],     //  insert the text "[math]" as the preview

preview: [["img",{src: "/images/mypic.jpg"}]],  // insert an image as the preview

See the description of HTML snippets for details on how to represent HTML code in this way.

skipTags: ["script","noscript","style","textarea","pre","code"]

This array lists the names of the tags whose contents should not be processed by tex2jax (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.

ignoreClass: "tex2jax_ignore"

This is the class name used to mark elements whose contents should not be processed by tex2jax (other than to look for the processClass pattern below). Note that this is a regular expression, and so you need to be sure to quote any regexp special characters. The pattern is automatically preceeded by '(^| )(' and followed by ')( |$)', so your pattern will have to match full words in the class name. Assigning an element this class name will prevent tex2jax from processing its contents.

processClass: "tex2jax_process"

This is the class name used to mark elements whose contents should be processed by tex2jax. 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 regexp special characters. The pattern is automatically preceeded by '(^| )(' and followed by ')( |$)', 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.

The mml2jax Preprocessor¶

The options below control the operation of the mml2jax preprocessor that is run when you include "mml2jax.js" in the extensions array of your configuration. They are listed with their default values. To set any of these options, include a mml2jax section in your MathJax.Hub.Config() call. For example

MathJax.Hub.Config({
  mml2jax: {
    preview: "none"
  }
});

would set the preview parameter to "none".

element: null

The id name of the element that should be processed by mml2jax. The default is the whole document.

preview: "alttext"

This controls whether mml2jax inserts MathJax_Preview spans to make a preview available, and what preview to use, when it locates mathematics on the page. The default is "alttext", which means use the <math> tag’s alttext attribute as the preview (visible until it is processed by MathJax), if the tag has one. Set it to "none" 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.

Examples:

preview: ["[math]"],     //  insert the text "[math]" as the preview

preview: [["img",{src: "/images/mypic.jpg"}]],  // insert an image as the preview

See the description of HTML snippets for details on how to represent HTML code in this way.

The jsMath2jax Preprocessor¶

The options below control the operation of the jsMath2jax preprocessor that is run when you include "jsMath2jax.js" in the extensions array of your configuration. They are listed with their default values. To set any of these options, include a jsMath2jax section in your MathJax.Hub.Config() call. For example

MathJax.Hub.Config({
  jsMath2jax: {
    preview: "none"
  }
});

would set the preview parameter to "none".

element: null

The id name of the element that should be processed by jsMath2jax. The default is the whole document.

preview: "TeX"

This controls whether jsMath2jax inserts MathJax_Preview 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 "TeX", which means use the TeX code as the preview (which will be visible until it is processed by MathJax). Set to "none" 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.

Examples:

preview: ["[math]"],     //  insert the text "[math]" as the preview

preview: [["img",{src: "/images/mypic.jpg"}]],  // insert an image as the preview

See the description of HTML snippets for details on how to represent HTML code in this way.

The TeX input processor¶

The options below control the operation of the TeX input processor that is run when you include "input/TeX" in the jax array of your configuration. They are listed with their default values. To set any of these options, include a TeX section in your MathJax.Hub.Config() call. For example

MathJax.Hub.Config({
  TeX: {
    Macros: {
      RR: '{\\bf R}',
      bold: ['{\\bf #1}', 1]
    }
  }
});

would set the Macros configuration option to cause two new macros to be defined within the TeX input processor.

TagSide: "right"

This specifies the side on which \tag{} macros will place the tags. Set it to "left" to place the tags on the left-hand side.

TagIndent: ".8em"

This is the amount of indentation (from the right or left) for the tags produced by the \tag{} macro.

MultLineWidth: "85%"

The width to use for the multline environment that is part of the AMSmath extension. This width gives room for tags at either side of the equation, but if you are displaying mathematics in a small area or a thin column of text, you might need to change the value to leave sufficient margin for tags.

Macros: {}

This lists macros to define before the TeX input processor begins. These are name:value pairs where the name gives the name of the TeX macro to be defined, and value gives the replacement text for the macro. The value canbe an array of the form [value,n], where value is the replacement text and n is the number of parameters for the macro. Note that since the value is a javascript string, backslashes in the replacement text must be doubled to prevent them from acting as javascript escape characters.

For example,

Macros: {
  RR: '{\\bf R}',
  bold: ['{\\bf #1}', 1]
}

would ask the TeX processor to define two new macros: \RR, which produces a bold-face “R”, and \bold{...}, which takes one parameter and set it in the bold-face font.

The MathML input processor¶

The options below control the operation of the MathML input processor that is run when you include "input/MathML" in the jax array of your configuration. They are listed with their default values. To set any of these options, include a MathML section in your MathJax.Hub.Config() call. For example

MathJax.Hub.Config({
  MathML: {
    useMathMLspacing: true
  }
});

would set the useMathMLspacing option so that the MathML rules for spacing would be used (rather than TeX spacing rules).

useMathMLspacing: false

Specifies whether to use TeX spacing or MathML spacing when the HTML-CSS output jax is used.

The HTML-CSS output processor¶

The options below control the operation of the HTML-CSS output processor that is run when you include "output/HTML-CSS" in the jax array of your configuration. They are listed with their default values. To set any of these options, include a "HTML-CSS" section in your MathJax.Hub.Config() call. Note that, because of the dash, you need to enclose the name in quotes. For example

MathJax.Hub.Config({
  "HTML-CSS": {
    preferredFont: "STIX"
  }
});

would set the preferredFont option to the STIX fonts.

scale: 100

The scaling factor (as a percentage) of math with respect to the surrounding text. The HTML-CSS output processor tries to match the en-size of the mathematics with that of the text where it is placed, but you may want to adjust the results using this scaling factor. The user can also adjust this value using the contextual menu item associated with the typeset mathematics.

availableFonts: ["STIX","TeX"]

This is a list of the fonts to look for on a user’s computer in preference to using MathJax’s web-based fonts. These must correspond to directories available in the jax/output/HTML-CSS/fonts directory, where MathJax stores data about the characters available in the fonts. Set this to ["TeX"], for example, to prevent the use of the STIX fonts, or set it to an empty list, [], if you want to force MathJax to use web-based or image fonts.

preferredFont: "TeX"

Which font to prefer out of the availableFonts list, when more than one is available on the user’s computer.

webFont: "TeX"

This is the web-based font to use when none of the fonts listed above are available on the user’s computer. Note that currently only the TeX font is available in a web-based form (they are stored in the fonts/HTML-CSS folder in the MathJax directory. Set this to null to disable web fonts.

imageFont: "TeX"

This is the font to use for image fallback mode (when none of the fonts listed above are available and the browser doesn’t support web-fonts via the @font-face CSS directive). Note that currently only the TeX font is available as an image font (they are stores in the fonts/HTML-CSS directory).

Set this to null if you want to prevent the use of image fonts (e.g., you have deleted or not installed the image fonts on your server). In this case, only browsers that support web-based fonts will be able to view your pages without having the fonts installed on the client computer. The browsers that support web-based fonts include: IE6 and later, Chrome, Safari3.1 and above, Firefox3.5 and later, and Opera10 and later. Note that Firefox3.0 is not on this list.

styles: {}

This is a list of CSS declarations for styling the HTML-CSS output. See the definitions in jax/output/HTML-CSS/config.js for some examples of what are defined by default. See CSS Style Objects for details on how to specify CSS style in a JavaScript object.

showMathMenu: true

This controls whether the MathJax contextual menu will be available on the mathematics in the page. If true, then right-clicking (on the PC) or control-clicking (on the Mac) will produce a MathJax menu that allows you to get the source of the mathematics in various formats, change the size of the mathematics relative to the surrounding text, get information about MathJax, and configure other MathJax settings.

Set this to false to disable the menu. When true, the MathMenu configuration block determines the operation of the menu. See the MathMenu options for more details.

tooltip: { ... }

This sets the configuration options for <maction> elements with actiontype="tooltip". (See also the #MathJax_Tooltip style setting in jax/output/HTML-CSS/config.js, which can be overridden using the styles option above.)

The tooltip section can contain the following options:

delayPost: 600

The delay (in milliseconds) before the tooltip is posted after the mouse is moved over the maction element.

delayClear: 600

The delay (in milliseconds) before the tooltop is cleared after the mouse moves out of the maction element.

offsetX: 10 and offsetY: 5

These are the offset from the mouse position (in pixels) where the tooltip will be placed.

The NativeMML output processor¶

The options below control the operation of the NativeMML output processor that is run when you include "output/NativeMML" in the jax array of your configuration. They are listed with their default values. To set any of these options, include a NativeMML section in your MathJax.Hub.Config() call. For example

MathJax.Hub.Config({
  NativeMML: {
    scale: 105
  }
});

would set the sale option to 105 percent.

scale: 100

The scaling factor (as a percentage) of math with respect to the surrounding text. Since the NativeMML output relies on the browser’s natiove MathML support, MathJax does not control the font size used in the mathematics. You may need to set this value to compensate for the size selected by the browser. The user can also adjust this value using the contextual menu item associated with the typeset mathematics.

showMathMath: true

This controls whether the MathJax contextual menu will be available on the mathematics in the page. If true, then right-clicking (on the PC) or control-clicking (on the Mac) will produce a MathJax menu that allows you to get the source of the mathematics in various formats, change the size of the mathematics relative to the surrounding text, get information about MathJax, and configure other MathJax settings.

Set this to false to disable the menu. When true, the MathMenu configuration block determines the operation of the menu. See the MathMenu options for more details.

showMathMenuMSIE: true

There is a separate menu setting for MSIE since the code to handle that is a bit delicate; if it turns out to have unexpected consequences, you can turn it off without turing off other the menu support in other browsers.

styles: {}

This is a list of CSS declarations for styling the HTML-CSS output. See the definitions in jax/output/NativeMML/config.js for some examples of what are defined by default. See CSS Style Objects for details on how to specify CSS style in a JavaScript object.

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. They are listed with their default values. To set any of these options, include a MMLorHTML section in your MathJax.Hub.Config() call. For example

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

would set the prefer option so that 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.

prefer: { MSIE: "MML", Firefox: "MML", 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 does process some MathML natively, its support is not sufficient to handle the more complicated output generated by MathJax, so its setting is "HTML" by default.

The MathMenu extension¶

The options below control the operation of the contextual menu that is available on mathematics that is typeset by MathJax. They are listed with their default values. To set any of these options, include a MathMenu section in your MathJax.Hub.Config() call. For example

MathJax.Hub.Config({
  MathMenu: {
    delay: 600
  }
});

would set the delay option to 600 milliseconds.

delay: 400

This is the hover delay for the display (in milliseconds) for submenus in the contextual menu: when the mouse is over a submenu label for this long, the menu will appear. (The submenu also will appear if you click on its label.)

helpURL: "http://www.mathjax.org/help/user/"

This is the URL for the MathJax Help menu item. When the user selects that item, the browser opens a new window with this URL.

showRenderer: true

This controls whether the “Math Renderer” item will be displayed in the the “Settings” submenu of the mathematics contextual menu. It allows the user to change between the HTML-CSS and NativeMML output processors for the mathematics on the page. Set to false to prevent this menu item from showing.

showContext: false

This controls whether the “Contextual Menu” item will be displayed in the the “Settings” submenu of the mathematics contextual menu. It allows the user to decide whether the MathJax menu or the browser’s default contextual manu will be shown when the context menu click occurs over mathematics typeset by MathJax. (The main reason to allow pass-through to the browser’s menu is to gain access to the MathPlayer contextual menu when the NativeMML output processor is used in Internet Explorer with the MathPlayer plugin.) Set to false to prevent this menu item from showing.

showFontMenu: false

This controls whether the “Font Preference” item will be displayed in the the “Settings” submenu of the mathematics contextual menu. This submenu lets the user select what font to use in the mathematics produced by the HTML-CSS output processor. Note that changing the selection in the font menu will cause the page to reload. Set to false to prevent this menu item from showing.

windowSettings: { ... }

These are the settings for the window.open() call that creates the Show Source window. The initial width and height will be reset after the source is shown in an attempt to make the window fit the output better.

styles: {}

This is a list of CSS declarations for styling the menu components. See the definitions in extensions/MathMenu.js for details of what are defined by default. See CSS Style Objects for details on how to specify CSS style in a JavaScript object.

The MathZoom extension¶

The options below control the operation of the Math-Zoom feature that allows users to see an enlarged version of the mathematics when they click or hover over typeset mathematics. They are listed with their default values. To set any of these options, include a MathZoom section in your MathJax.Hub.Config() call. For example

MathJax.Hub.Config({
  MathZoom: {
    delay: 600
  }
});

would set the delay option to 600 milliseconds.

Mathematics is zoomed when the user “triggers” the zoom by an action, either clicking on the mathematics, double-clicking on it, or holding the mouse still over it (i.e., “hovering”). Which trigger is used is set by the user via the math contextual menu (or by the author using the menuSettings configuration section).

delay: 400

This the time (in milliseconds) that the mouse must be still over a typeset mathematical formula before the zoomed version is displayed (when the zoom trigger is set to Hover).

styles: {}

This is a list of CSS declarations for styling the zoomed mathematics. See the definitions in extensions/MathZoom.js for details of what are defined by default. See CSS Style Objects for details on how to specify CSS style in a JavaScript object.

The FontWarnings extension¶

The options below control the operation of the FontWarnings extension that is run when you include "FontWarnings.js" in the extensions array of your configuration. They are listed with their default values. To set any of these options, include a FontWarnings section in your MathJax.Hub.Config() call. For example

MathJax.Hub.Config({
  FontWarnings: {
    fadeoutTime: 2*1000
  }
});

would set the fadeoutTime option to 2000 milliseconds (2 seconds).

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 CSS style objects for details about how to specify CSS styles via javascript objects.

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:

webFont: [ ... ]

The message used for when MathJax uses web-based fonts (rather than local fonts installed on the user’s system).

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).

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).

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 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

   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.

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:

closeBox

The HTML for the close box in the FontWarning message.

webfonts

The HTML for a paragraph suggesting an upgrade to a more modern browser that supports web fonts.

fonts

HTML that includes links to the MathJax and STIX font download pages.

STIXfonts

HTML that gives the download link for the STIX fonts only. (Used in place of fonts when the HTML-CSS option for availableFonts only includes the STIX fonts.)

TeXfonts

HTML that gives the download link for the MathJax TeX fonts only. (Used in place of fonts when the HTML-CSS option for availableFonts only includes the TeX fonts.)

You can add your own pre-defined HTML snippets to this object, or override the ones that are there with your own text.

removeAfter: 12*1000

This is the amount of time to show the FontWarning message, in milliseconds. The default is 12 seconds.

fadeoutSteps: 10

This is the number of steps to take while fading out the FontWarning message. More steps make for a smoother fade-out.

fadeoutTime: 1.5*1000

This is the time used to perform the fade-out, in milliseconds. The default is 1.5 seconds.

Installing MathJax in WordPress¶

These instructions assume you already have placed the MathJax files on your server (see Installing MathJax).

1. Open the WordPress admin interface.

2. In the administration menu on the left, open up the Appearance menu and click on the Editor submenu option.

   

   When you click on the editor option, WordPress should open up the first stylesheet in the current theme.

3. In the template list on the right side of the page, click on the header file (it should be header.php).

   

   This part depends slightly on how your current theme is written. In the header.php file, look for the end-of-head tag, </head>. If you find it, insert

   <script type="text/javascript" src="path-to-MathJax/MathJax.js"></script>
   

   just before that. Otherwise, insert the same code at the very bottom of the file. Here, path-to-MathJax should be replaced by the web-address of the main MathJax directory on your server, e.g., src="/mathjax/MathJax.js".

4. Save the file. This should enable MathJax, so you should be able to start adding mathematical content to your pages. Use the config/MathJas.js file in the MathJax directory to configure MathJax to your needs (see Configuring MathJax for details).

Using MathJax in Movable Type¶

These instructions assume you already have placed the MathJax files on your server (see Installing and Testing MathJax).

1. Open Moveable Type Admin interface for the site on which you want to enable MathJax.

2. In the dashboard menu on the left, open up the Design menu. This should show you the templates you are currently using on the site.

   

3. Scroll down to the Template Modules section in the template list and open the HTML Head template.

   

4. At the end of the file, insert

   <script type="text/javascript"  src="path-to-MathJax/MathJax.js"></script>
   

   where path-to-MathJax is replaced by the web-address of the main MathJax dorectory on your server.

   

5. Save the file. This should enable MathJax, so you should be able to start adding mathematical content to your pages. Use the config/MathJas.js file in the MathJax directory to configure MathJax to your needs (see Configuring MathJax for details).