scribble-math/dockers/MathJaxFonts
Emily Eisenberg 2d2d319287 Fix the docker command
Auditors: alpert
2014-08-30 22:42:26 -07:00
..
Dockerfile Fix the OS/2 font tables to prevent clipping on windows 2014-08-08 17:55:33 -07:00
README.md Fix the docker command 2014-08-30 22:42:26 -07:00

How to generate MathJax fonts


It's really simple (now)! Just make a docker image from the included Dockerfile using a command like

sudo docker build --tag=mathjaxfonts .

from within this directory (note you need to have docker installed and running for this to work). This will build a docker image with the mathjaxfonts tag, which you can then use to run dockers based on them. Then, run a mathjaxfonts docker with

sudo docker run --interactive --tty --name mjf mathjaxfonts /bin/bash

We name this docker "mjf" so we can reference it later when we want to copy the files off. (If you get an error about the name being in use, perhaps because you are trying to create another docker, you can either delete the old docker with

sudo docker rm mjf

or use a different name.) This will get you into the docker in the root directory. From there, cd into the /MathJax-dev/fonts/OTF/TeX directory, and run

make ttf eot woff

to build all of the fonts that we need. Finally, leave the docker and copy all the files off with

docker cp mjf:/MathJax-dev/fonts/OTF/TeX/ttf ./ docker cp mjf:/MathJax-dev/fonts/OTF/TeX/eot ./ docker cp mjf:/MathJax-dev/fonts/OTF/TeX/woff ./

(note we're using mjf: to specify the name of the docker we created above) Compile the fonts into a single directory

mv {ttf,eot,woff}/* ./

Remove the WinIE6 and WinChrome fonts

rm KaTeX_Win*

And you're good to go! Don't forget to update the font metrics with the metric_parse.rb script once you're done.

General Docker Help


When you quit the docker, it will stop the docker from running. If you want to reattach to the docker, you can start it again with

sudo docker start mjf

and then attach with

sudo docker attach mjf

Alternatively, if you want to detach from the docker when you're done instead of quitting and stopping it, you can detach with C-p C-q, and then re-attach with

sudo docker attach mjf

To see a list of your current dockers, you can run

docker ps