apsis-book/content/concepts
dev 9caa542b52 Write the formulas in the notation Markdown has for them
A formula was written as a fenced code block, which is what a plain text
file allows and is not what Markdown has for mathematics. A code block is
code: the reader of the source sees a formula presented as code, and the
renderer had been taught to guess which blocks held equations, which is a
guess that is wrong whenever a block holds something else.

Every formula now stands between dollar signs, which is the notation every
Markdown mathematics renderer reads, and the guess is gone from the
renderer. A hundred and four blocks became two hundred and four formulas
in the two languages.

Three things that were in a code block were not formulas and are now what
they are. A paragraph of geometry was prose. A table of the exponent
notation is a table, because its two columns are a written form and what
it means. Two blocks are left as they were: the layer diagram, which is a
diagram, and a sample element set, which has to keep its column alignment.

The renderer learned what the notation needs and did not have: matrix
environments, with an ampersand between the columns of a row and a double
backslash between the rows; the floor and ceiling marks; the modulo
operator; a mark above an argument, as in the time derivative of Omega and
a barred coefficient; the text command, whose argument is words and was
being set one letter at a time; and the spacing commands.

The check on the formulas covered the concept documents and not the
interface documentation, so every formula there was unexamined. It covers
both now, and it treats a command name and an environment name as
notation, which is what they are: neither is drawn as the letters of its
own name.
2026-10-02 11:52:17 +08:00
..
foundation Write the formulas in the notation Markdown has for them 2026-10-02 11:52:17 +08:00
implementation web: describe the field by layer and separate it from the implementation 2026-10-01 13:57:23 +08:00
network Write the formulas in the notation Markdown has for them 2026-10-02 11:52:17 +08:00
ops Write the formulas in the notation Markdown has for them 2026-10-02 11:52:17 +08:00
orbit Write the formulas in the notation Markdown has for them 2026-10-02 11:52:17 +08:00
physics Write the formulas in the notation Markdown has for them 2026-10-02 11:52:17 +08:00
rf Write the formulas in the notation Markdown has for them 2026-10-02 11:52:17 +08:00
sim web: describe the field by layer and separate it from the implementation 2026-10-01 13:57:23 +08:00
chapters.json web: split the physics layer, render formulas, and fix the graph load 2026-10-01 17:28:43 +08:00
overview.md web: describe the field by layer and separate it from the implementation 2026-10-01 13:57:23 +08:00
overview.zh.md web: describe the field by layer and separate it from the implementation 2026-10-01 13:57:23 +08:00