Update readthedocs configuration (#798)

* temporarily use requirements.txt

* update requirements

* update conf.py

* Test different approach for dependency install

* next attempt

---------

Co-authored-by: Brendan Collins <brendan@makepath.com>

Author: tcmetzger

.readthedocs.yml

@@ -10,6 +10,9 @@ build:
   os: ubuntu-22.04
   tools:
     python: "3.12"
+  jobs:
+    pre_build:
+      - pip install '.[doc,tests]'
 
 # Build documentation in the "docs/" directory with Sphinx
 sphinx:
@@ -19,8 +22,9 @@ sphinx:
 # to build your documentation
 # See https://docs.readthedocs.io/en/stable/guides/reproducible-builds.html
 python:
-   install:
+  install:
+#    - requirements: docs/docs-requirements.txt
     - method: pip
       path: .
-      extra_requirements:
-        - [doc, tests]
+      # extra_requirements:
+      #   - [doc, tests]

docs/docs-requirements.txt

@@ -0,0 +1,17 @@
+dask[dataframe]
+geopandas
+Jinja2 >=2.11
+ipykernel
+matplotlib
+nbsphinx
+numpydoc
+pandoc
+pydata_sphinx_theme
+sphinx
+sphinx-panels
+sphinx_rtd_theme
+flake8
+isort
+noise >= 1.2.2
+pytest
+pytest-cov

docs/source/conf.py

@@ -44,7 +44,6 @@
     'sphinx.ext.napoleon',
     'sphinx.ext.viewcode',
     'sphinx.ext.autosummary',
-    'sphinx_multiversion',
     'nbsphinx',
     'sphinx.ext.mathjax',
     'matplotlib.sphinxext.plot_directive',