Add custom fonts directly to Matplotlib

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

Author: QuLogic

.github/workflows/main.yaml

@@ -48,8 +48,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: |

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
@@ -35,17 +35,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,8 @@
+from pathlib import Path
+
+from matplotlib.font_manager import fontManager
+
+
+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 sys
 from pathlib import Path
 
 import numpy as np
@@ -12,6 +13,9 @@
 
 
 REPO = Path(__file__).parent.parent
+sys.path.append(str(REPO / "fonts"))
+import custom_fonts  # noqa
+
 
 fig = plt.figure(figsize=(4.25, 4.25 * 95/115))
 ax = fig.add_axes([0, 0, 1, 1], frameon=False, aspect=1,

scripts/advanced-plots.py

@@ -4,6 +4,7 @@
 # -----------------------------------------------------------------------------
 
 # Scripts to generate all the basic plots
+import sys
 from pathlib import Path
 
 import numpy as np
@@ -12,6 +13,9 @@
 
 
 REPO = Path(__file__).parent.parent
+sys.path.append(str(REPO / "fonts"))
+import custom_fonts  # noqa
+
 
 fig = plt.figure(figsize=(0.4, 0.4))
 mpl.rcParams['axes.linewidth'] = 0.5

scripts/anatomy.py

@@ -4,6 +4,7 @@
 # License: BSD
 # ----------------------------------------------------------------------------
 
+import sys
 from pathlib import Path
 
 import numpy as np
@@ -12,6 +13,9 @@
 
 
 REPO = Path(__file__).parent.parent
+sys.path.append(str(REPO / "fonts"))
+import custom_fonts  # noqa
+
 
 np.random.seed(123)
 

scripts/annotate.py

@@ -2,6 +2,7 @@
 # Matplotlib cheat sheet
 # Released under the BSD License
 # -----------------------------------------------------------------------------
+import sys
 from pathlib import Path
 
 import numpy as np
@@ -10,6 +11,9 @@
 
 
 REPO = Path(__file__).parent.parent
+sys.path.append(str(REPO / "fonts"))
+import custom_fonts  # noqa
+
 
 fig = plt.figure(figsize=(6, 1))
 # ax = plt.subplot(111, frameon=False, aspect=.1)

scripts/annotation-arrow-styles.py

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

scripts/annotation-connection-styles.py

@@ -1,9 +1,12 @@
+import sys
 from pathlib import Path
 
 import matplotlib.pyplot as plt
 
 
 REPO = Path(__file__).parent.parent
+sys.path.append(str(REPO / "fonts"))
+import custom_fonts  # noqa
 
 
 def demo_con_style(ax, connectionstyle):

scripts/basic-plots.py

@@ -4,6 +4,7 @@
 # -----------------------------------------------------------------------------
 
 # Scripts to generate all the basic plots
+import sys
 from pathlib import Path
 
 import numpy as np
@@ -12,6 +13,9 @@
 
 
 REPO = Path(__file__).parent.parent
+sys.path.append(str(REPO / "fonts"))
+import custom_fonts  # noqa
+
 
 fig = plt.figure(figsize=(0.4, 0.4))
 mpl.rcParams['axes.linewidth'] = 0.5

scripts/colorbar.py

@@ -3,6 +3,7 @@
 # Released under the BSD License
 # -----------------------------------------------------------------------------
 
+import sys
 from pathlib import Path
 
 import numpy as np
@@ -11,6 +12,9 @@
 
 
 REPO = Path(__file__).parent.parent
+sys.path.append(str(REPO / "fonts"))
+import custom_fonts  # noqa
+
 
 fig = plt.figure(figsize=(6, .65))
 # ax = plt.subplot(111, frameon=False, aspect=.1)

scripts/colormaps.py

@@ -1,10 +1,14 @@
+import sys
 from pathlib import Path
 
 import numpy as np
 import matplotlib.pyplot as plt
 
 
 REPO = Path(__file__).parent.parent
+sys.path.append(str(REPO / "fonts"))
+import custom_fonts  # noqa
+
 
 figsize = 4.0, 0.25
 fig = plt.figure(figsize=figsize)

scripts/colornames.py

@@ -6,13 +6,17 @@
 Simple plot example with the named colors and its visual representation.
 """
 
+import sys
 from pathlib import Path
 
 import matplotlib.pyplot as plt
 from matplotlib import colors as mcolors
 
 
 REPO = Path(__file__).parent.parent
+sys.path.append(str(REPO / "fonts"))
+import custom_fonts  # noqa
+
 
 colors = dict(mcolors.BASE_COLORS, **mcolors.CSS4_COLORS)
 

scripts/colors.py

@@ -3,6 +3,7 @@
 # Released under the BSD License
 # -----------------------------------------------------------------------------
 
+import sys
 from pathlib import Path
 
 import numpy as np
@@ -11,6 +12,9 @@
 
 
 REPO = Path(__file__).parent.parent
+sys.path.append(str(REPO / "fonts"))
+import custom_fonts  # noqa
+
 
 figsize = 4.0, 0.25
 fig = plt.figure(figsize=figsize)

scripts/extents.py

@@ -3,6 +3,7 @@
 # Released under the BSD License
 # -----------------------------------------------------------------------------
 
+import sys
 from pathlib import Path
 
 # Scripts to generate all the basic plots
@@ -12,6 +13,9 @@
 
 
 REPO = Path(__file__).parent.parent
+sys.path.append(str(REPO / "fonts"))
+import custom_fonts  # noqa
+
 
 Z = np.arange(5*5).reshape(5, 5)
 

scripts/fonts.py

@@ -2,12 +2,16 @@
 # Matplotlib cheat sheet
 # Released under the BSD License
 # -----------------------------------------------------------------------------
+import sys
 from pathlib import Path
 
 import matplotlib.pyplot as plt
 
 
 REPO = Path(__file__).parent.parent
+sys.path.append(str(REPO / "fonts"))
+import custom_fonts  # noqa
+
 
 fig = plt.figure(figsize=(4.25, 3.8))
 ax = fig.add_axes([0, 0, 1, 1], frameon=False, xticks=[], yticks=[],
@@ -17,13 +21,13 @@
 
 # -----------------------------------------------------------------------------
 variants = {
-    "normal" : "../fonts/eb-garamond/EBGaramond08-Regular.otf",
-    "small-caps" : "../fonts/eb-garamond/EBGaramondSC08-Regular.otf"
+    "normal" : "EB Garamond",
+    "small-caps" : "EB Garamond SC"
 }
 
 text = "The quick brown fox jumps over the lazy dog"
-for i, (variant, file) in enumerate(variants.items()):
-    ax.text(1, y, text, size=9, va="center", font=Path(file).resolve())
+for i, (variant, family) in enumerate(variants.items()):
+    ax.text(1, y, text, size=9, va="center", family=family)
 
     ax.text(39, y, variant,
             color="0.25", va="center", ha="right",

scripts/interpolations.py

@@ -1,10 +1,14 @@
+import sys
 from pathlib import Path
 
 import matplotlib.pyplot as plt
 import numpy as np
 
 
 REPO = Path(__file__).parent.parent
+sys.path.append(str(REPO / "fonts"))
+import custom_fonts  # noqa
+
 
 methods = [None, 'none', 'nearest', 'bilinear', 'bicubic', 'spline16',
            'spline36', 'hanning', 'hamming', 'hermite', 'kaiser', 'quadric',

scripts/layouts.py

@@ -2,6 +2,7 @@
 # Matplotlib cheat sheet
 # Released under the BSD License
 # -----------------------------------------------------------------------------
+import sys
 from pathlib import Path
 
 import numpy as np
@@ -11,6 +12,9 @@
 
 
 REPO = Path(__file__).parent.parent
+sys.path.append(str(REPO / "fonts"))
+import custom_fonts  # noqa
+
 
 fig = plt.figure(figsize=(0.4, 0.4))
 margin = 0.01

scripts/legend.py

@@ -2,6 +2,7 @@
 # Matplotlib cheat sheet
 # Released under the BSD License
 # -----------------------------------------------------------------------------
+import sys
 from pathlib import Path
 
 import numpy as np
@@ -10,6 +11,9 @@
 
 
 REPO = Path(__file__).parent.parent
+sys.path.append(str(REPO / "fonts"))
+import custom_fonts  # noqa
+
 
 fig = plt.figure(figsize=(4, 4))
 ax = fig.add_axes([0.15, 0.15, .7, .7], frameon=True, aspect=1,

scripts/linestyles.py

@@ -2,13 +2,17 @@
 # Matplotlib cheat sheet
 # Released under the BSD License
 # -----------------------------------------------------------------------------
+import sys
 from pathlib import Path
 
 import numpy as np
 import matplotlib.pyplot as plt
 
 
 REPO = Path(__file__).parent.parent
+sys.path.append(str(REPO / "fonts"))
+import custom_fonts  # noqa
+
 
 fig = plt.figure(figsize=(4.25, 2*.55))
 ax = fig.add_axes([0, 0, 1, 1], xlim=[0.75, 10.25], ylim=[0.5, 2.5], frameon=False,

scripts/markers.py

@@ -2,13 +2,17 @@
 # Matplotlib cheat sheet
 # Released under the BSD License
 # -----------------------------------------------------------------------------
+import sys
 from pathlib import Path
 
 import numpy as np
 import matplotlib.pyplot as plt
 
 
 REPO = Path(__file__).parent.parent
+sys.path.append(str(REPO / "fonts"))
+import custom_fonts  # noqa
+
 
 # Markers
 # -----------------------------------------------------------------------------

scripts/plot-variations.py

@@ -4,6 +4,7 @@
 # -----------------------------------------------------------------------------
 
 # Scripts to generate all the basic plots
+import sys
 from pathlib import Path
 
 import numpy as np
@@ -12,6 +13,9 @@
 
 
 REPO = Path(__file__).parent.parent
+sys.path.append(str(REPO / "fonts"))
+import custom_fonts  # noqa
+
 
 fig = plt.figure(figsize=(0.4, 0.4))
 mpl.rcParams['axes.linewidth'] = 0.5