occam-styles 4.1.110 → 4.1.112

package/README.md

@@ -12,9 +12,9 @@
 
 ## Introduction
 
-This package contains colour definitions together with user interface and syntax schemes. It also contains various images, in either native or JSX form. A distribution of [FiraCode](https://github.com/tonsky/FiraCode) is also included.
+This package contains colour definitions together with user interface and syntax schemes; various images, in either native or JSX form; and the some of the [JuliaMono](https://juliamono.netlify.app/) typeface in Woff2 format.
 
-There is a small example application to view the images in JSX form.
+There is a small example application to view the images in JSX form and so on.
 
 ## Installation
 
@@ -32,6 +32,45 @@ You can also clone the repository with [Git](https://git-scm.com/)...
 
 You can also run a development server, see the section on building later on.
 
+## Changes to the JuliaMono typeface
+
+For those that are interested, here are the steps.
+
+### Stripping ligatures and contextual alternate characters
+
+Assuming that you have relatively recent versions of Python and VirtualEnv installed, firstly create and activate a virtual environment...
+
+```
+virtualenv venv
+source venv/bin/activate
+```
+
+...then install Python's `foottools` package...
+
+```
+pip install fonttools
+```
+
+...and then, lastly, assuming that you have created the requisite `source` and `output` directories, run the following or similar:
+
+```
+pyftsubset source/JuliaMono-Bold.ttf --output-file=output/JuliaMono-Bold.ttf --layout-features-=calt,liga
+```
+
+### Compressing the TTF files to Woff2 format
+
+Homebrew has the necessary utilities:
+
+```
+brew install woof2
+```
+
+Compression is then straightforward, for example:
+
+```
+woff2_compress JuliaMono-Regular.ttf
+```
+
 ## Building
 
 Automation is done with [npm scripts](https://docs.npmjs.com/misc/scripts), have a look at the `package.json` file. The pertinent commands are:
@@ -53,6 +92,10 @@ The example will then be available at http://localhost:8888 and will reload auto
 
 * The logo was converted to SVG format with Peter Selinger's [Potrace](http://potrace.sourceforge.net/).
 
+* Occam's pretty printer uses the [JuliaMono](https://juliamono.netlify.app/) typeface distributed under the [SIL Open Font License (OFL)](https://scripts.sil.org/cms/scripts/page.php?site_id=nrsi&id=ofl).
+
+* [Fredrik Ekre](https://fredrikekre.se/) provided the script to strip out ligatures and contextual alternate characters from JuliaMono.
+
 ## Contact
 
 * james.smith@openmathematics.org