DOC: Fix Sphinx documentation

Fix Sphinx documentation.
SlicerDMRI · Oct 17, 2023 · d327c4a · d327c4a
1 parent f9d47da
commit d327c4a
Show file tree

Hide file tree

Showing 4 changed files with 7 additions and 3 deletions.
diff --git 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/Makefile b/doc/Makefile
@@ -5,7 +5,7 @@
 # from the environment for the first two.
 SPHINXOPTS    ?=
 SPHINXBUILD   ?= sphinx-build
-SOURCEDIR     = doc
+SOURCEDIR     = source
 BUILDDIR      = build
 
 # Put it first so that "make" without argument is like "make help".

diff --git 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
@@ -3,6 +3,6 @@ Welcome to the whitematteranalysis documentation!
 
 .. toctree::
     :maxdepth: 1
+    :caption: Reference
 
-    bin
-    utilities
+    modules