Update .readthedocs.yml configuration

Newest Read the Docs configuration file requires explicit specification
of the environment (using `build:`).

Upgrading to newer Python environments has also forced us to use an
older Jinja2 that works with out legacy Sphinx module.

.readthedocs.yml

@@ -1,5 +1,14 @@
+# Read the Docs configuration file for Sphinx projects
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+# Required
 version: 2
 
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.11"
+
 # Extra formats
 # PDF generation is failing for now; disabled on 2020-12-02
 #formats:
@@ -10,7 +19,5 @@ sphinx:
   configuration: docs/conf.py
 
 python:
-  # make sure we're using Python 3
-  version: 3
   install:
     - requirements: docs/requirements.txt

docs/requirements.txt

@@ -8,3 +8,5 @@ sphinxcontrib-bibtex
 numpy
 six
 future
+# Old Sphinx requires an old Jinja2
+jinja2<3.1