diff --git a/.readthedocs.yaml b/.readthedocs.yaml index 2f6d2d05..e8b53c57 100644 --- a/.readthedocs.yaml +++ b/.readthedocs.yaml @@ -13,6 +13,9 @@ build: apt_packages: - libblas-dev - liblapack-dev + jobs: + pre_build: + - sphinx-apidoc -f -o doc . # Build documentation in the doc/ directory with Sphinx sphinx: diff --git a/doc/conf.py b/doc/conf.py index d74a0545..ef585716 100644 --- a/doc/conf.py +++ b/doc/conf.py @@ -67,6 +67,7 @@ # ones. extensions = [ "sphinx.ext.autodoc", + "sphinx.ext.napoleon", ] # Add any paths that contain templates here, relative to this directory. diff --git a/doc/index.rst b/doc/index.rst index 201b2763..4531c8d4 100644 --- a/doc/index.rst +++ b/doc/index.rst @@ -3,6 +3,6 @@ Welcome to the whitematteranalysis documentation! .. toctree:: :maxdepth: 1 + :caption: Reference - bin - utilities + modules