## Section 7 Mathematics

To be able to create both LaTeX and HTML output (plus variations), we rely on MathJax, which in turn supports an extensive subset of the mathematical symbols normally available. The AMSMath symbol set is a good approximation. For a complete list, see the MathJax Supported LaTeX commands. We load the `AMSsymbols`

library and the library for extensible arrows, `extpfeil`

.

### Subsection 7.1 Basic Mathematics

The following is from the MathJax demonstration page, an identity due to Ramanujan:

And again, from the MathJax demonstration page, Maxwell's equations:

A small test that the extensible arrows library is included properly:

Look back at the top of the source file of this document to see how to include your TeX macros just once. For best results keep your macros simple and semantic.

Chris Hughes has made available “slanted”, or “beveled”, or “nice” fractions. To wit, we mean fractions such as: \(\sfrac{3}{8}\text{.}\) Use the built-in `\sfrac{}{}`

macro in your mathematics to achieve this presentation.

We consider a system of equations. We number the first and last equation (there are just two) and include an `xml:id`

on each. We reference the whole system later as the range of equations from the first to the last.

### Subsection 7.2 Displayed Mathematics

Multi-line displays of mathematics are achieved with the `md`

tag (“math display”), and the variant that produces numbers on each line, `mdn`

(“math display numbered”), used within a paragraph (`p`

). As a good example of how XML syntax is superior, you author \(n\) lines of equations by enclosing each line inside of a `mrow`

tag, rather than using \(n-1\) separators (such as `\\`

).

If you use no ampersands to express alignment (read ahead), then each equation is centered independently on the width of the text. This is implemented according to the AMSmath LaTeX package's `gather`

environment. Example:

An ampersand is used, in two ways, to describe positioning several equations per line, organized in columns. We suggest in Subsection 8.1 that the pre-defined LaTeX macro `\amp`

is the safest way to specify these. The second, fourth, sixth, … ampersands separate columns, and the spacing between columns will be provided automatically. The first, third, fifth, … ampersands are alignment points for the equations in each column. Typically this is placed just prior to a binary operator, such as an equal sign (`\amp = `

), or for a column of explanations or commentary, just prior to the `\text{}`

macro. Note that this scenario suggests always having an odd number of ampersands in each `mrow`

. In the example below, alignment is on the equals sign in the first two columns, and provides left-justification to the explanations in the third column. N.B.: the use below of the `\text{}`

macro does not include mathematics within its argument. Doing so may yield unpredictable results depending on your choice of delimiters for the mathematics (and using an `m`

tag will be ineffective).

PreTeXt will automatically detect the presence or absence of ampersands, but by defining macros for entire aligned equations, you can effectively hide the ampersands. So the `@alignment`

attribute can override automatic detection. We use a simple LaTeX macro to demonstrate setting `alignment='align'`

to override the use of a `gather`

environment and use a `align`

environment instead. Example:

The AMSmath LaTeX package's `alignat`

environment is a third variant of alignment. It never happens automatically, you need to ask for it with `alignment="alignat"`

. It is very similar to `align`

but adds no space between the equation columns. So you can leave it that way, or you can add your own “extra” space to suit. Here is a previous example with no inter-column space:

This modified example has a middle row with three columns, while the other rows have just one column, as a test of our routines for determining the `mrow`

with the greatest number of ampersands (and how many there are),

Final example demonstrates that ampersands in other objects (matrices here) can wreak havoc with computing the number of columns. So we provide yet another attribute to override automatic detection, `alignat-columns`

. This is the number of *columns* not the number of *ampersands*. Generally, for \(c\) columns, there will be \(2c-1\) ampersands.

One caveat: if your number of ampersands is even (see advice above about using an odd number) behavior should still be correct, as in next example.

If you want super-precise control over alignment of the terms of a system of equations (linear or not) you can use the `alignat`

option to advantage by not including any extra space. This example is modified slightly from a post by Alex Jordan:

Beautiful.

A long equation, to check layout on various screen sizes. This is Weil's “explicit formula” for the Riemann \(\zeta\)-function:

In print versions, a long run of displayed equations often needs to be broken across pages. If you are reading some other version of this, then there is nothing to see here. But for LaTeX output it could be interesting. First, with no extra effort, this page-long display should break naturally, no matter how the preceding material changes.

In this version we have turned off page breaking for the entire display, but then allowed a break at every fourth equation, so you should see a reasonably attractive page break right after one of the \(m^2+n^2=p^2\) equations.

So. Do not take any extra steps and let LaTeX figure out the breaks. If you do not like a break, modify the `md`

or `mdn`

to go back to the AMSmath default behavior and not break at all. Ever. Or rather, go further and modify an individual `mrow`

to suggest that it is a good place for a break.

This is a poorly-authored paragaph to test the conversion to HTML. There are two displayed equations, separated by a period ending the first one's sentence, which should migrate into the display, and not leave behind an empty paragraph:

This final sentence should remain, inside another HTML paragraph, without the second equation's period.

### Subsection 7.3 LaTeX Packages and MathJax Extensions

If you would like to use macros from a LaTeX package *and* there is a MathJax extension *of the same name* which implements the same macros, then you may use these with your mathematics as we demonstrate here.

This example is from Jason Underdown. The package is named `cancel`

and is included in the TeXLive distribution, so is fairly standard. The particular macro being demonstrated is `\cancelto{}{}`

.

Look at the source of this article to see the package name being supplied in a `latex-preamble/package`

element within the `docinfo`

section. That is the only setup required to make the macro usable in LaTeX and HTML output.

The packages appear before the author-supplied macros, so you can use macros from the packages as building blocks for document-specific macros. We cannot guarantee there will be no conflicts between additional packages and those in use normally, or added in the future. So use at your own risk.

### Subsection 7.4 Advanced Mathematics

MathJax is extremely capable in rendering a subset of LaTeX in web browsers, and improving all the time. You can get fairly fancy with some of its supported commands. In particular, if you need to mix in a few words with your mathematics, the `\text{}`

macro is supported. For example, you might use an “if” or an “otherwise” in the definition of a piecewise function.

Consider that the first line below is text sandwiched in-between two Greek letters, wrapped in a `\text{}`

macro. In HTML output we have taken care that the font for text material within display mathematics should match the font of the surrounding paragraph, as also happens with LaTeX output. The second line is nearly identical in the source, but is just naked text being rendered like a slew of variables.

We are not suggesting here that using words in place of symbols, as in the first line, is a good practice. (It is not.)

The following example is a good stress-test of using the `\text{}`

macro to achieve certain effects. Note the Unicode left and right smart quotes. This a contribution from Alex Jordan as part of his work on APEX Calculus.

And another one from Alex. Note the use of the `\mathord{}`

and `\mathrel{}`

macros to control spacing around the mathematical symbols. Examine the source to see how the quotation marks have been authored with XML syntax for Unicode characters.

Generally, you cannot use any XML elements inside of the mathematics elements. An exception is the `xref`

element which you might want to use to provide justifications for the steps of a derivation. Here is a visual example that is mathematically meaningless,

### Subsection 7.5 Local Tags on Equations

If you are not writing a research monograph, maybe (a) you will not use many numbered equations, or do not like the looks of them, or feel they scare your readers, and (b) maybe your cross-references are always local-ish, like strictly within an `example`

or a `proof`

. For this situation you can create, and employ, a “local” tag on a displayed equation. Nothing enforces the idea of what constitutes local, and there is nothing to stop you from using the same symbols more than once. With freedom comes responsibility.

Use the `@tag`

attribute on an `mrow`

, only. (Remember, you can have just one `mrow`

.) The behavior is identical within an `md`

or `mdn`

. The value of the `@tag`

attribute is a symbol name. The prefix `d`

means “double”, and the prefix `t`

means “triple”. So allowed values are

star, dstar, tstar dagger, ddagger, tdagger hash, dhash, thash maltese, dmaltese, tmaltese

Cross-references to these tagged equations happens in the usual way and should behave as expected.

Here is a local cross-reference: (\(\star\star\)). We test another farther away in Section 17, contrary to our advice above.