File: a11y-extensions.rst

package info (click to toggle)
mathjax-docs 2.7%2B20161014-1
  • links: PTS, VCS
  • area: main
  • in suites: stretch
  • size: 1,080 kB
  • ctags: 14
  • sloc: sh: 22; python: 19; makefile: 8
file content (121 lines) | stat: -rw-r--r-- 3,589 bytes parent folder | download
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
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
.. _a11y-extensions:

****************************
The Accessibility extensions
****************************

MathJax maintains a set of extensions for providing advanced 
accessibility features. These extensions are an official part
of MathJax are but stored in a separate code repository as well as
on the CDN at `cdn.mathjax.org/mathjax/contrib/a11y/`.

The full documentation is available `on GitHub <https://github.com/mathjax/MathJax-a11y/blob/master/docs/README.md>`_
and we summarize the options below.

Each accessibility extension can be loaded using the ``[Contrib]``
path variable. The following extensions have configuration options.

accessibility-menu.js
---------------------

The standard approach is to only load the accessibility menu
extension which provides opt-ins for end-users via the MathJax 
menu. 

.. code-block:: javascript
  MathJax.Hub.Config({
    // ...your configuration options...
    extensions: ["[Contrib]/a11y/accessibility-menu.js"]
  });
  
The accessibility menu extension can then be controlled in the
configuration block for the MathJax menu, e.g.,

.. code-block:: javascript
  MathJax.Hub.Config({
    // ...your configuration options...
    menuSettings: {
      collapsible: false, 
      autocollapse: false,
      explorer: false
    }
  });

.. note::

  The accessibility menu is part of all :ref:`combined configurations <config-files>`.

explorer.js
-----------

The Explorer extension provides exploration tools for 
sub-expressions. It is the largest piece of the accessibility 
extensions, controlling highlighting, navigation and voicing.

.. code-block:: javascript
  MathJax.Hub.Config({
    // ...your configuration options...
    explorer: {
      walker: 'syntactic',         // none, syntactic, semantic
      highlight: 'none',           // none, hover, flame
      background: 'blue',          // blue, red, green, yellow, cyan, magenta, white, black
      foreground: 'black',         // black, white, magenta, cyan, yellow, green, red, blue
      speech: true,                // true, false
      generation: 'lazy',          // eager, mixed, lazy
      subtitle: true,              // true, false
      ruleset: 'mathspeak-default' // mathspeak-default, mathspeak-brief, mathspeak-sbrief, chromevox-default, chromevox-short, chromevox-alternative
    }
  });


auto-collapse.js
----------------

This extension will automatically collapse sub-expressions
to allow the resulting equation to fit in the viewport width
and will react to changes in viewport width. 
It will automatically load ``collapsible.js`` (see below).


.. code-block:: javascript
  MathJax.Hub.Config({
    // ...your configuration options...
    "auto-collapse": {
      disabled: false;
    }
  });

collapsible.js
--------------

This extension generates a complexity metric and inserts elements 
that allow the expressions to be collapsed by the user by clicking 
on the expression based on that metric.

The extension only offers a configuration option to disable it.


.. code-block:: javascript
  MathJax.Hub.Config({
    // ...your configuration options...
    collapsible: {
      disabled: false;
    }
  });

semantic-enrich.js
------------------

This extension coordinates the creation and embedding of semantic 
information generated by the enrichment process 
within the MathJax output for use by the other extensions.

The extension only offers a configuration option to disable it.

.. code-block:: javascript
  MathJax.Hub.Config({
    // ...your configuration options...
    "semantic-enrich": {
      disabled: false;
    }
  });