nlbdev / mathml-guidelines

A collaboration on the MathML guidelines for marking up accessible math
1 stars 1 forks source link

Clarify the use of <mtext> #11

Open samimaattaCelia opened 5 months ago

samimaattaCelia commented 5 months ago

<mtext> is supposed to be for text inside mathematical text, but the examples in MathML 4 <mtext> or MathML Core aren't good. I would just write <p>Theorem 1:</p> and continue with MathML. I wouldn't necessarily mix up pure text and MathML at all if possible.

Potential use cases for <mtext>

Maybe in indeces $g_{weight}$. This could be marked up as

<msub>
<mi>g</mi>
<mtext>weight</mtext>
</msub>

(at least to my understanding).

Commentary (as is described in MathML 4 and MathML Core, but not shown in examples). Example of a pair of equations with commentary that might be used in a math textbook:

$2x = 4 \ \vert :2 \ \text{(divide by two)}$ $x = 4$

Any others?

samimaattaCelia commented 5 months ago

Noticed that this sort of relates to issue #10, since I talk about a subscript index and I offer mark up that is different than what Tim was suggesting.

samimaattaCelia commented 3 months ago

Relates to #32.