Update config for ReadTheDocs

Author: luktug-ltd

.readthedocs.yaml

@@ -0,0 +1,36 @@
+ 
+# .readthedocs.yaml
+# Read the Docs configuration file
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+# Required
+version: 2
+
+# Set the version of Python and other tools you might need
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.11"
+    # You can also specify other tool versions:
+    # nodejs: "16"
+    # rust: "1.55"
+    # golang: "1.17"
+  apt_packages:
+    - build-essential
+    - gmsh
+    - calculix-ccx
+    - libglu1-mesa
+
+
+# Build documentation in the docs/ directory with Sphinx
+sphinx:
+   configuration: docs/conf.py
+
+# If using Sphinx, optionally build your docs in additional formats such as PDF
+# formats:
+#    - pdf
+
+# Optionally declare the Python requirements required to build your docs
+python:
+   install:
+   - requirements: docs/requirements.txt

docs/conf.py

@@ -1,13 +1,15 @@
 import sys, os
 import mock
 
+sys.path.insert(0, os.path.abspath('../pyccx'))
+sys.path.insert(0, os.path.abspath('..'))
+
 from pyccx.version import __version__
 
 
 # If extensions (or modules to document with autodoc) are in another directory,
 # add these directories to sys.path here. If the directory is relative to the
 # documentation root, use os.path.abspath to make it absolute, like shown here.
-sys.path.insert(0, os.path.abspath('..'))
 
 # -- General configuration -----------------------------------------------------
 

docs/requirements.txt

@@ -1,8 +1,15 @@
-sphinx==4.5.0
+sphinx
 sphinx-automodapi
-sphinx-autodoc-typehints==1.10.3
+sphinx-autodoc-typehints
 sphinx-paramlinks
+sphinx_rtd_theme
 autodocsumm
 pypandoc
-m2r2
-gmsh>=4.14.0
+mock
+furo
+numpy
+matplotlib
+trimesh
+m2r2==0.3.4
+gmsh>=4.14.0
+docutils==0.21.2