Add custom fonts directly to Matplotlib

This removes the need to manually install them system- or user-wide.

Author: QuLogic

.github/workflows/main.yaml

@@ -55,8 +55,6 @@ jobs:
           sudo sed -i '/disable ghostscript format types/,+6d' /etc/ImageMagick-6/policy.xml
           #
           make -C fonts/
-          cp -r fonts/ /usr/share/fonts/
-          fc-cache
           make all
       - name: Run checks
         run: |

.gitignore

@@ -16,6 +16,7 @@ handout-*.png
 # ----------------------------------
 figures/*.pdf
 fonts/**/*.[ot]tf
+fonts/__pycache__/
 
 # html build
 docs/_build/*

README.md

@@ -15,7 +15,7 @@ Beginner handout [(download pdf)](https://matplotlib.org/cheatsheets/handout-beg
 
 ## How to compile
 
-1. You need to create a `fonts` repository with:
+1. You need to fill the `fonts` directory with:
 
 * `fonts/roboto/*`           : See https://fonts.google.com/specimen/Roboto
                                 or https://github.com/googlefonts/roboto/tree/master/src/hinted
@@ -34,17 +34,6 @@ On Linux, with `make` installed, the fonts can be set up with the following comm
 make -C fonts
 ```
 
-The fonts can be made discoverable by `matplotlib` (through `fontconfig`) by creating the following in `$HOME/.config/fontconfig/fonts.conf` (see [here](https://www.freedesktop.org/software/fontconfig/fontconfig-user.html)):
-
-```xml
-<?xml version="1.0"?>
-<!DOCTYPE fontconfig SYSTEM "fonts.dtd">
-<fontconfig>
-<dir>/path/to/cheatsheets/fonts/</dir>
-...
-</fontconfig>
-```
-
 
 2. You need to generate all the figures:
 

fonts/custom_fonts.py

@@ -0,0 +1,9 @@
+from pathlib import Path
+
+from matplotlib.font_manager import fontManager
+
+
+def setup():
+    here = Path(__file__).parent.resolve()
+    for font in here.glob('*/*.[ot]tf'):
+        fontManager.addfont(font)

scripts/adjustements.py

@@ -3,6 +3,7 @@
 # Released under the BSD License
 # -----------------------------------------------------------------------------
 import pathlib
+import sys
 
 import numpy as np
 import matplotlib as mpl
@@ -12,6 +13,10 @@
 
 
 ROOT_DIR = pathlib.Path(__file__).parent.parent
+sys.path.append(str(ROOT_DIR / "fonts"))
+import custom_fonts  # noqa
+custom_fonts.setup()
+
 
 mpl.style.use([
     ROOT_DIR / 'styles/base.mplstyle',

scripts/advanced-plots.py

@@ -5,13 +5,18 @@
 
 # Script to generate all the advanced plots
 import pathlib
+import sys
 
 import numpy as np
 import matplotlib as mpl
 import matplotlib.pyplot as plt
 
 
 ROOT_DIR = pathlib.Path(__file__).parent.parent
+sys.path.append(str(ROOT_DIR / "fonts"))
+import custom_fonts  # noqa
+custom_fonts.setup()
+
 
 mpl.style.use([
     ROOT_DIR / 'styles/base.mplstyle',

scripts/anatomy.py

@@ -4,6 +4,7 @@
 # License: BSD
 # ----------------------------------------------------------------------------
 import pathlib
+import sys
 
 import numpy as np
 import matplotlib as mpl
@@ -12,6 +13,10 @@
 
 
 ROOT_DIR = pathlib.Path(__file__).parent.parent
+sys.path.append(str(ROOT_DIR / "fonts"))
+import custom_fonts  # noqa
+custom_fonts.setup()
+
 
 mpl.style.use([
     ROOT_DIR / 'styles/base.mplstyle',

scripts/annotate.py

@@ -3,13 +3,18 @@
 # Released under the BSD License
 # -----------------------------------------------------------------------------
 import pathlib
+import sys
 
 import numpy as np
 import matplotlib as mpl
 import matplotlib.pyplot as plt
 
 
 ROOT_DIR = pathlib.Path(__file__).parent.parent
+sys.path.append(str(ROOT_DIR / "fonts"))
+import custom_fonts  # noqa
+custom_fonts.setup()
+
 
 fig = plt.figure(figsize=(6, 1))
 # ax = plt.subplot(111, frameon=False, aspect=.1)

scripts/annotation-arrow-styles.py

@@ -1,10 +1,15 @@
 import pathlib
+import sys
 
 import matplotlib.pyplot as plt
 import matplotlib.patches as mpatches
 
 
 ROOT_DIR = pathlib.Path(__file__).parent.parent
+sys.path.append(str(ROOT_DIR / "fonts"))
+import custom_fonts  # noqa
+custom_fonts.setup()
+
 
 styles = mpatches.ArrowStyle.get_styles()
 

scripts/annotation-connection-styles.py

@@ -1,10 +1,15 @@
 import pathlib
+import sys
 
 import matplotlib as mpl
 import matplotlib.pyplot as plt
 
 
 ROOT_DIR = pathlib.Path(__file__).parent.parent
+sys.path.append(str(ROOT_DIR / "fonts"))
+import custom_fonts  # noqa
+custom_fonts.setup()
+
 
 mpl.style.use([
     ROOT_DIR / 'styles/base.mplstyle',