html
The html extension gives you access to some HTML features like styles, classes, element ID’s, and clickable links. It defines the following non-standard macros:
- \\href{url}{math}
Makes
math
be a link to the page given byurl
. Note that the url is not processed by TeX, but is given as the literal url. In actual TeX or LaTeX, special characters must be escaped; so, for example, a url containing a#
would need to use\#
in the url in actual TeX. That is not necessary in MathJax, and if you do use\#
, it will produce/#
in the url (since the\
will be inserted into the url verbatim, and browsers will convert that to/
(thinking it is a DOS directory separator).
- \\class{name}{math}
Attaches the CSS class
name
to the output associated withmath
when it is included in the HTML page. This allows your CSS to style the element.
- \\cssId{id}{math}
Attaches an id attribute with value
id
to the output associated withmath
when it is included in the HTML page. This allows your CSS to style the element, or your javascript to locate it on the page.
- \\style{css}{math}
Adds the give
css
declarations to the element associated withmath
.
For example:
x \href{why-equal.html}{=} y^2 + 1
(x+1)^2 = \class{hidden}{(x+1)(x+1)}
(x+1)^2 = \cssId{step1}{\style{visibility:hidden}{(x+1)(x+1)}}
Note
For the \href
macro, the url parameter is not processed
further, as it is in actual TeX, so you do not need to quote special
characters. For example, \href{#section1}{x}
is fine, but
\href{\#section}{x}
will not work as expected.
This extension is loaded automatically when the autoload extension
is used. To load the html extension explicitly, add
'[tex]/html'
to the load
array of the loader
block of
your MathJax configuration, and add 'html'
to the packages
array of the tex
block.
window.MathJax = {
loader: {load: ['[tex]/html']},
tex: {packages: {'[+]': ['html']}}
};
Alternatively, use \require{html}
in a TeX expression to load it
dynamically from within the math on the page, if the require
extension is loaded.
html Commands
The html extension implements the following macros:
\class
, \cssId
, \href
, \style