www

Unnamed repository; edit this file 'description' to name the repository.
Log | Files | Refs | README

README.md (1739B)


      1 ### How to generate MathJax fonts
      2 ---------------------------------
      3 
      4 It's really simple (now)! Just make a docker image from the included Dockerfile
      5 using a command like
      6 
      7     sudo docker build --tag=mathjaxfonts .
      8 
      9 from within this directory (note you need to have docker installed and running
     10 for this to work). This will build a docker image with the mathjaxfonts tag,
     11 which you can then use to run dockers based on them. Then, run a mathjaxfonts
     12 docker with
     13 
     14     sudo docker run --interactive --tty --name mjf mathjaxfonts /bin/bash
     15 
     16 We name this docker "mjf" so we can reference it later when we want to copy the
     17 files off. (If you get an error about the name being in use, perhaps because you
     18 are trying to create another docker, you can either delete the old docker with
     19 
     20     sudo docker rm mjf
     21 
     22 or use a different name.) This will get you into the docker in the root
     23 directory. From there, cd into the `/MathJax-dev/fonts/OTF/TeX` directory, and
     24 run
     25 
     26     make ttf eot woff woff2
     27 
     28 to build all of the fonts that we need. Finally, leave the docker and copy all
     29 the files off with the `copy_fonts.sh` script:
     30 
     31     ./copy_fonts.sh mjf
     32 
     33 And you're good to go! Don't forget to update the font metrics with `make
     34 metrics`.
     35 
     36 ### General Docker Help
     37 -----------------------
     38 
     39 When you quit the docker, it will stop the docker from running. If you want to
     40 reattach to the docker, you can start it again with
     41 
     42     sudo docker start mjf
     43 
     44 and then attach with
     45 
     46     sudo docker attach mjf
     47 
     48 Alternatively, if you want to detach from the docker when you're done instead of
     49 quitting and stopping it, you can detach with `C-p C-q`, and then re-attach with
     50 
     51     sudo docker attach mjf
     52 
     53 To see a list of your current dockers, you can run
     54 
     55     docker ps