Add your font with a pull request
If you made an OpenType math font, finished or not, add a folder and open a pull request on the catalog's repository. A check runs on it with mathra: in a few minutes it comments what passed, how many math symbols the font has and which ones it lacks. A draft pull request gets the report too, so you can use it to test a font you are still drawing.
- A folder
fonts/your-font/with the font file, its license asLICENSE.txt, and afont.toml. - The pull requestA draft is fine. Everything can be done on GitHub's website, with nothing to install.
- The reportThe check comments on the pull request: the checks, the coverage of math symbols by block, and what is missing.
- The mergeYour font gets its own page with your name, and joins the grid and the comparison.
font.toml
name = "Euler Math"
file = "Euler-Math.otf"
license = "OFL-1.1" # OFL-1.1, GUST-Font-License, Apache-2.0 or MIT
style = "handwritten" # serif, sans, tex or handwritten
base = "Euler" # the text family it goes with
designer = "Hermann Zapf" # optional
source = "https://ctan.org/pkg/euler-math"
sample = '\nabla \times \vec{B} = \mu_0 \vec{J}' # optional: shown first on its page
[upstream] # optional: where the file can be downloaded again
url = "https://mirrors.ctan.org/fonts/euler-math.zip"
path = "euler-math/Euler-Math.otf"
What the check requires
- An OpenType or TrueType file with a MATH table. A text font, however good, cannot set a fraction or a radical.
- A license that lets the catalog share the file: OFL 1.1, GUST, Apache 2.0 or MIT, with its text in
LICENSE.txt. - The file as you published it: not subset, not converted. Under the OFL, a changed file cannot keep a reserved font name.
- A name no other font in the catalog has.
The coverage of math symbols is information, not a requirement: a font with few symbols is welcome, and its page says which ones it lacks.
The details are in CONTRIBUTING.md.
No font yet? You can draw one by hand on a printed grid.