A pull parser for mathml
rendering.
This project is inspired KaTeX
, Temml
, MathJax
, etc. It is actively maintained, and is in a stage of development where
95% of what KaTeX
and the likes support is properly working and minimally tested. This software
should be functional for most use cases. However, it is not recommended for large scale production
use as more robust testing is required.
Follow modern LaTeX principles:
Ideally, this library should be mostly compatible with latex2e
and amsmath
. The term
mostly is used here to refer to the mathematical commands exposed by these packages; typesetting prose
is out of scope for this crate. Another consequence of this goal is that some plain-TeX commands that
are deprecated (e.g., \atop
, \over
, etc.) are not supported by this crate.
Closely resemble conventional LaTeX:
It is a goal for this crate to make efforts in generating aesthetic equations. This means that
the mathml
output may be tweaked to make it resemble what pdflatex
, KaTeX
or MathJax
outputs.
- All the things
temml
andkatex
test - Cargo Mutants
- Errors
For later:
- Better documentation for state changes, and for invariants that the parser satisfies.
-
Dimension
values are unnecessarily big - Square bracket matrices do not have equal spacing on the left and the right.
- Italic numbers are not italic because they do not exist in unicode.
-
\bar
make a tiny bar, should be bigger. - Color API rework
-
\sideset
- Changing
catcode
s of characters \if
* macros^^_
&^^[0-9a-f][0-9a-f]
as a way of specifying characters- Redefining active characters This library currently only supports default active characters, and hence does not allow for the definition of active characters.
- Implicit characters as whitespace tokens
As in the TeXbook p. 265, Knuth specifies that a
space token
stands for an explicit or implicit space. This library does not currently support implicit space tokens when aspace token
is required. - Use of internal values and parameters, such as registers, and things like
\tolerance
(See TeXbook p. 267 for a complete definition) \magnification
parameter &true
sizes- Case insensitive keywords matching.
According to TeXbook p. 265, keywords such as
pt
,em
,true
, etc. are matched case insensitively (e.g.,pT
would matchpt
). This library does not support this behavior, as keywords must match exactly (i.e.,em
,true
,pt
, etc.). fil
units TeX allows the use offil
(ll...) units, this library does not.\outer
specifier on definitions\edef
, we do not support pre-expansion of macros.\csname
&\endcsname
\begingroup
and{
, and\endgroup
and}
behave the same way; that is to say,\begingroup
and\endgroup
do not have the property of "keeping the same mode" (TeXbook p. 275).- All vertical list manipulation commands.
Things like
\vskip
,\vfil
,\moveleft
etc. \hfil
,\hfill
\over
,\atop
, and all deprecated "fraction like" control sequences.
- Macros preamble
- Wrap
- Left equation numbers
colorIsTextColor
ThrowOnError
maxSize
trust
\toggle
groups
Sources used during the development of this crate. Any reference in code comments refer to these links specifically.