Skip to content

Restructure Tabular Math section and update guidelines with examples#92

Merged
AndersEkl merged 3 commits intomainfrom
change_order_content
May 8, 2026
Merged

Restructure Tabular Math section and update guidelines with examples#92
AndersEkl merged 3 commits intomainfrom
change_order_content

Conversation

@MartheGjelstad
Copy link
Copy Markdown
Contributor

…ng many lines

In the existing guidelines the sections "Systems of Equations" and "Equations solving notation" are inside the section "Context-based Applications". However, they are listed in the section "When to use MathML <mtable>. I changed the order of some sections. The order is now the following:

Basic Markup Structure
	Token Elements
		`<mn>`
		`<mo>` for operators, fences, separators or accents
		`<mi>` element for variables, functions and units
		Text inside math expressions `<mtext>`
			Punctuation
	General Layout Schemata
		Grouping mathematical expressions with `<mrow>`
		Fractions, binomials and other similar layouts with `<mfrac>`
		`<msqrt>` and `<mroot>`
		`<mpadded>` and `<mspace>`
		Visual alignment of expressions
	Script and Limit Schemata
		Subscripts and Superscripts, `<msub>`, `<msup>`, `<msubsup>`
		Underscripts and Overscripts, `<munder>`, `<mover>`, `<munderover>`
		Prescripts and Postscripts, `<mmultiscripts>`
Tabular Math
	When to use the regular HTML `<table>`
	When to use the MathML `<mtable>`
		Attributes `rowspan` and `columnspan`
		Systems of Equations
		Equation solving notation
		Labeling and referencing equations
Footnotes in mathematical expressions
Context-Based Applications
	Large operators
		Inline
		Block
		Inline-block
	Invisible Operators
	Numbers with Units
	Fill-in-the-blanks
	When to use images of mathematical content
		Crossed out math `<menclose>`
	Chemistry in MathML
Copy link
Copy Markdown
Collaborator

@TimArborealis TimArborealis left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good to me!

</td>
<td>
<math xmlns="http://www.w3.org/1998/Math/MathML">
<mstyle scriptlevel="-1">
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

scriptlevel should be possible to set on the <math> element. Did you try this and see if it works?

I'm mostly raising this since <mstyle> isn't recommended in the MathML Core.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the input, @samimaattaCelia . See the discussion in issue #85 :)

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks! Is there an expected change coming to the validator, since scriptlevel should be allowed in all MathML elements? I don't want that the guidelines have to abide by rules that are not based in the standard.

For now it is ok, but in the future, I don' think this should be the aim of the guidelines.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

When we are going to update the guidelines to include elements from MathML 4, the validator needs to be updated. I don't have a planned timeline for this. First, two of us need to go through the MathML 4 guidelines and take notes of what we should include in our guidelines. So far, no one has said they want to do this. I think this is because everyone is quite busy with other stuff right now :)

Copy link
Copy Markdown
Collaborator

@samimaattaCelia samimaattaCelia left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Edit: Apparently I didn't know how to use this approving thing. Other than the <mstyle> comment above, the changes seem good!

Seems good!

@AndersEkl
Copy link
Copy Markdown
Collaborator

Looks good to me. We need to do a major update of the validator in the near future, not only for the purpose of MathML but also to synch with the 2025-1 EPUB guidelines.

@AndersEkl AndersEkl merged commit 80380d5 into main May 8, 2026
4 checks passed
@MartheGjelstad MartheGjelstad deleted the change_order_content branch May 8, 2026 10:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

4 participants