Use normal GHA runner since it has unzip and git

Also preload fonts so that, at worst, text flashes only the first time the website is opened.

Author: tfpf

.github/workflows/pages.yml

@@ -24,12 +24,14 @@ jobs:
       name: github-pages
       url: ${{ steps.deployment.outputs.page_url }}
     runs-on: ubuntu-latest
-    container: sphinxdoc/sphinx
     steps:
       - uses: actions/checkout@v4
+        with:
+          lfs: true
       - uses: actions/configure-pages@v5
       - run: unzip fonts.zip
         working-directory: docs/_static/
+      - uses: actions/setup-python@v5
       - run: pip install -r requirements.txt && sphinx-build . _build
         working-directory: docs/
       - uses: actions/upload-pages-artifact@v3

docs/_templates/base.html

@@ -0,0 +1,10 @@
+{% extends "!base.html" %}
+{% block extrahead %}
+  <link rel="preload" href="_static/fonts/JetBrainsMono/JetBrainsMonoNerdFont-Regular.ttf" as="font" type="font/ttf" crossorigin />
+  <link rel="preload" href="_static/fonts/JetBrainsMono/JetBrainsMonoNerdFont-Italic.ttf" as="font" type="font/ttf" crossorigin />
+  <link rel="preload" href="_static/fonts/JetBrainsMono/JetBrainsMonoNerdFont-Bold.ttf" as="font" type="font/ttf" crossorigin />
+  <link rel="preload" href="_static/fonts/JetBrainsMono/JetBrainsMonoNerdFont-BoldItalic.ttf" as="font" type="font/ttf" crossorigin />
+  <link rel="preload" href="_static/fonts/Signika/Signika-Regular.ttf" as="font" type="font/ttf" crossorigin />
+  <link rel="preload" href="_static/fonts/Signika/Signika-Bold.ttf" as="font" type="font/ttf" crossorigin />
+  {{ super() }}
+{% endblock %}

docs/conf.py

@@ -29,3 +29,4 @@
 html_use_index = False
 
 myst_heading_anchors = 3
+templates_path = ["_templates"]