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
|
.. _tex-html:
####
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:
.. describe:: \\href{url}{math}
Makes ``math`` be a link to the page given by ``url``. 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).
.. describe:: \\class{name}{math}
Attaches the CSS class ``name`` to the output associated with
``math`` when it is included in the HTML page. This allows your
CSS to style the element.
.. describe:: \\cssId{id}{math}
Attaches an id attribute with value ``id`` to the output
associated with ``math`` 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.
.. describe:: \\style{css}{math}
Adds the give ``css`` declarations to the element associated with
``math``.
For example:
.. code-block:: latex
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.
.. code-block:: javascript
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.
-----
.. _tex-html-commands:
html Commands
-------------
The `html` extension implements the following macros:
``\class``, ``\cssId``, ``\href``, ``\style``
|-----|
|
