Docs builds are failing on readthedocs.io (#208)

* Docs builds are failing on readthedocs.io
Fixes #207

* use mamba

* test build

* linkify-it-py

.readthedocs.yml

@@ -1,15 +1,16 @@
 version: 2
 
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "mambaforge-22.9"
+
 sphinx:
   configuration: sphinx-docs/source/conf.py
 
-formats: all
-
-build:
-  image: latest
+formats:
+  - pdf
+  - epub
 
 conda:
   environment: sphinx-docs/source/environment.yml
-
-python:
-    version: "3.8"

CHANGELOG.md

@@ -39,6 +39,12 @@ If MD5 sum is not listed for a certain release then it means that the container
 
 * Miscellaneous goes here
 
+## [1.5.1] - 2023-10.20
+
+### Fixed
+
+* Fixed broken ReadTheDocs documentation build
+
 ## [1.5.0] - 2023-10-17
 
 ### Added

sphinx-docs/source/environment.yml

@@ -3,9 +3,10 @@ channels:
   - conda-forge
   - defaults
 dependencies:
-  - python=3.8
+  - python=3.11
   - sphinx
   - sphinx_rtd_theme
   - sphinx-design
   - myst-parser
   - make
+  - linkify-it-py

version/version.py

@@ -2,7 +2,7 @@
 _MINOR = "5"
 # On main and in a nightly release the patch should be one ahead of the last
 # released build.
-_PATCH = "0"
+_PATCH = "1"
 # This is mainly for nightly builds which have the suffix ".dev$DATE". See
 # https://semver.org/#is-v123-a-semantic-version for the semantics.
 _SUFFIX = ""