Replace sphinx napoleon for numpydoc

boule/_ellipsoid.py

@@ -62,6 +62,8 @@ class Ellipsoid:
     comments : str or None
         Additional comments regarding the ellipsoid (optional).
 
+    Notes
+    -----
 
     .. caution::
 

boule/_sphere.py

@@ -59,6 +59,8 @@ class Sphere:
     comments : str or None
         Additional comments regarding the ellipsoid (optional).
 
+    Notes
+    -----
 
     .. caution::
 

doc/_templates/autosummary/class.rst

@@ -10,36 +10,25 @@ Attributes
 ----------
 
 {% for item in attributes %}
-
 .. autoattribute:: {{ objname }}.{{ item }}
-
 {% endfor %}
 
 {% endif %}
 
-Methods
--------
-
-.. rubric:: List of methods
 
-.. autosummary::
-    {% for item in methods %}
-    {% if item != "__init__" %}
-        {{ objname }}.{{ item }}
-    {% endif %}
-    {% endfor %}
+{% if methods %}
 
-.. rubric:: Methods documentation
+Methods
+-------
 
 {% for item in methods %}
 {% if item != '__init__' %}
 .. automethod:: {{ objname }}.{{ item }}
-
-----
-
 {% endif %}
 {% endfor %}
 
+{% endif %}
+
 .. raw:: html
 
      <div style='clear:both'></div>

doc/conf.py

@@ -22,13 +22,13 @@
 extensions = [
     "sphinx.ext.autodoc",
     "sphinx.ext.autosummary",
+    "numpydoc",
     "sphinx.ext.coverage",
     "sphinx.ext.mathjax",
     "sphinx.ext.doctest",
     "sphinx.ext.viewcode",
     "sphinx.ext.extlinks",
     "sphinx.ext.intersphinx",
-    "sphinx.ext.napoleon",
     "sphinx_design",
     "sphinx_copybutton",
     "jupyter_sphinx",
@@ -48,11 +48,12 @@
 # Autosummary pages will be generated by sphinx-autogen instead of sphinx-build
 autosummary_generate = []
 
-# Otherwise, the Return parameter list looks different from the Parameters list
-napoleon_use_rtype = False
-# Otherwise, the Attributes parameter list looks different from the Parameters
-# list
-napoleon_use_ivar = True
+# Create cross-references for the parameter types in the Parameters, Other
+# Parameters, Returns and Yields sections of the docstring
+numpydoc_xref_param_type = True
+
+# Format the Attributes like the Parameters section.
+numpydoc_attributes_as_param_list = True
 
 # Sphinx project configuration
 templates_path = ["_templates"]

env/requirements-docs.txt

@@ -1,5 +1,6 @@
 # Requirements for building the documentation
 sphinx==7.2.*
+numpydoc==1.7.*
 sphinx-book-theme==1.1.*
 sphinx-copybutton==0.5.*
 sphinx-design==0.5.*

environment.yml

@@ -20,6 +20,7 @@ dependencies:
   - pymap3d>=2.9
   # Documentation
   - sphinx==7.2.*
+  - numpydoc==1.7.*
   - sphinx-book-theme==1.1.*
   - sphinx-copybutton==0.5.*
   - sphinx-design==0.5.*