MathML Document Repository

Core properties


literal and common core properties: details

Example Defaults

The :literal and :common core properties establish a set of defaults for speaking every MathML element that MathML intent generators can assume and that AT should implement. That does not mean that the exact words are specified, only that AT chooses words that convey the default meaning. For example: msup is spoken as “super” or “superscript” or some similar words and not “power” if that element or some ancestor includes the :literal property.

The exact words may depend upon both the audience and the children of node. Some examples for $x^2$ if msup or some ancestor has the :literal property:

For someone who is blind, it may be important to indicate the start and end of fractions, roots, etc., but for someone with dyslexia, the extra words might be “verbal noise.”

literal property

The default meanings and special cases for all the MathML elements are:

common property

The default meanings and special cases for all the MathML elements are:

Special Notations

Trig

The following is a minimum list of trig functions that should be recognized and spoken appropriately: “cos”, “cosec”, “cosech”, “cosh”, “cot”, “cotan”, “cotanh”, “coth”, “csc”, “csch”, “sec”, “sech”, “sin”, “sinh”, “tan”, “tang”, “tanh”, “tg”, “ln”, “log”, “lg”. Other languages may add localized versions to this list.

If these names are encountered, they typically are expanded to their full name: “csc” would be “co-secant” in English; “sinh” would be “hyperbolic sine”, etc.

As noted above, a trig function raised to a “-1” power should have special speech. For example, $sin^{-1} x$ might be spoken as “inverse sine of x”, “arc sine of x”, or “sine inverse of x”.

NamedSets: ℂ, ℕ, ℚ, ℝ, and ℤ

These are spoken in a special way, although maybe that is just the default way to speak those Unicode characters.

However, adding subscripts and superscripts of various types (e.g., $\mathbb {Z}^2$, $\mathbb {Z}^+$, and $\mathbb {Z}_2$) often have specialized speech such as “Z 2”.