Update RTD integration (#2)

* Add `LIBCARNA_PYTHON_NBSPHINX_EXECUTE` environment variable

* Add docs building for testing to CI

* Update RTD integration, remove doc building from CI

* Update docs/conf.py

* Update .readthedocs.yaml

* Update .readthedocs.yaml

* Update .readthedocs.yaml

Author: kostrykin

.readthedocs.yaml

@@ -12,11 +12,6 @@ sphinx:
 conda:
   environment: environment.yml
 
-# Install doc-building dependencies
-python:
-  install:
-    - requirements: docs/requirements.txt
-
 # Specify the build process
 build:
   os: ubuntu-24.04
@@ -25,4 +20,9 @@ build:
   jobs:
     install:
       - bash ./linux_build.bash
-      - pip install libcarna_python-*.whl
+      - pip install dist/libcarna_python-*.whl
+    pre_build:
+      - pip install -r docs/requirements.txt
+    build:
+      html:
+        - LIBCARNA_PYTHON_NBSPHINX_EXECUTE=never sphinx-build -M html docs $READTHEDOCS_OUTPUT

docs/conf.py

@@ -17,7 +17,8 @@
 import sys
 
 LIBCARNA_PYTHON_PATH = os.environ.get('LIBCARNA_PYTHON_PATH')
-sys.path.append(LIBCARNA_PYTHON_PATH)
-os.environ['PYTHONPATH'] = LIBCARNA_PYTHON_PATH + ':' + os.environ.get('PYTHONPATH', '')
+if LIBCARNA_PYTHON_PATH is not None:
+    sys.path.append(LIBCARNA_PYTHON_PATH)
+    os.environ['PYTHONPATH'] = LIBCARNA_PYTHON_PATH + ':' + os.environ.get('PYTHONPATH', '')
 
-nbsphinx_execute = 'always'
+nbsphinx_execute = os.environ.get('LIBCARNA_PYTHON_NBSPHINX_EXECUTE', 'always')