rtd: use pip (#457)

* rtd: use pip

* use py3.12

* update comments

* remove env file from assume-unchanged

* require ipython

Author: mathause

.readthedocs.yml

@@ -7,14 +7,10 @@ build:
       - git fetch --unshallow
     pre_install:
         # see https://github.com/readthedocs/readthedocs.org/issues/8201
-      - git update-index --assume-unchanged docs/environment.yml docs/source/conf.py
-      # install mesmer
-      # * needs to be editable
-      # * --no-deps to ensure minimal required deps
-      - python -m pip install --no-deps -e .
+      - git update-index --assume-unchanged docs/source/conf.py
+      # editable install mesmer with docs extras
+      - python -m pip install -e .[docs]
   tools:
-    python: mambaforge-22.9
+    python: "3.12"
 sphinx:
   configuration: docs/source/conf.py
-conda:
-  environment: docs/environment.yml

docs/environment.yml

@@ -56,9 +56,10 @@ viz =
     nc-time-axis
 
 docs =
+    ipython
     numpydoc
-    sphinx-book-theme
     sphinx
+    sphinx-book-theme
 
 tests =
     pytest-cov