fixed rtd issue (#477)

* fixed regression in read the docs builds

Author: AndrewAnnex

.readthedocs.yml .readthedocs.yaml.readthedocs.yml renamed to .readthedocs.yaml

@@ -2,12 +2,19 @@
 # Read the Docs configuration file
 # See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
 
-build:
-  image: stable
-
 # Required
 version: 2
 
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "mambaforge-22.9"
+
+# use a conda environment
+conda:
+  environment: docs/environment.yml
+
+
 # Build documentation in the docs/ directory with Sphinx
 sphinx:
   configuration: docs/conf.py
@@ -18,12 +25,7 @@ formats:
   - epub
   - pdf
 
-# use a conda environment
-conda:
-  environment: docs/environment.yml
-
 python:
-   version: 3.11
-   install:
-     - method: pip
-       path: .
+  install:
+    - method: pip
+      path: .

docs/conf.py

@@ -39,6 +39,7 @@
     "sphinx.ext.inheritance_diagram",
     "sphinx_copybutton",
     "myst_parser",
+    'sphinx_rtd_theme',
 ]
 
 # conf for copybutton
@@ -112,7 +113,7 @@
 
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
-html_theme = "default"
+html_theme = "sphinx_rtd_theme"
 
 # Theme options are theme-specific and customize the look and feel of a theme
 # further.  For a list of options available for each theme, see the

docs/environment.yml

@@ -5,12 +5,15 @@ channels:
   - nodefaults
 
 dependencies:
-  - python=3.11
-  - numpy
-  - sphinx>=3.1.2
-  - myst-parser
+  - python=3.10
+  - numpy==1.25.2
+  - myst-parser==2.0.0
+  - docutils
+  - graphviz
+  - sphinx<=7.0.0
   - sphinx-copybutton
+  - sphinx-autodoc-typehints
+  - recommonmark
   - pip
-  - pip:
-    - sphinx_autodoc_typehints
-
+variables:
+  CONDA_APPEND_CORE_REQUIREMENTS: False