Fix plotting documentation

Issue with matplotlib installation that prevented the plotting page to
be loaded. This was due to a `poetry` installation command.

Also added intersphinx mappings for plotting functionality and made some
text changes to docstrings.

.gitignore

@@ -1,7 +1,8 @@
 # Directories
 __pycache__/
+_build/
 
 # Testing
 .hypothesis
 .ruff_cache
-.pytest_cache
+.pytest_cache

.readthedocs.yml

@@ -17,9 +17,11 @@ formats: [pdf]
 build:
   os: ubuntu-20.04
   tools:
-    python: '3.10'
+    python: "3.10"
 python:
   install:
     - requirements: docs/requirements.txt
     - method: pip
       path: .
+      extra_requirements:
+        - plotting

afids_utils/metrics.py

@@ -65,7 +65,7 @@ def mean_distances(
     template_afid_set: AfidSet,
     component: str = "distance",
 ) -> list[float]:
-    """Calculate the average distance for a given spatial component betweeen
+    """Calculate the average distance for a given spatial component between
     a collection of ``AfidSet`` objects and a common / template ``AfidSet``.
 
     Parameters

afids_utils/plotting.py

@@ -87,11 +87,11 @@ def plot_ortho(
     nii_img: nib.nifti1.Nifti1Image,
     opacity: float = 1,
 ) -> StatMapView:
-    """Generate interactive, html ortho view of the slices. Uses ``nilearn``
-    to generate the figures.
+    """Generate interactive, html ortho view of the slices. Uses
+    ``nilearn.plotting`` to generate the figures.
 
     The generated view can either be opened interactively or saved as a figure
-    per ``nilearn`` functionality:
+    per ``nilearn.plotting`` functionality:
         * Interactive view - ``view.open_in_browser()``
         * Save - ``view.save_as_html(file_name.html)``
 
@@ -108,7 +108,6 @@ def plot_ortho(
 
     opacity:
         Opacity value [0 - transparent, 1 - opaque] of overlaid AFIDs
-        (default: 0.8)
 
     Returns
     -------

docs/api/transform.md

@@ -3,4 +3,4 @@
 ```{eval-rst}
     .. automodule:: afids_utils.transforms
         :members:
-```
+```

docs/conf.py

@@ -80,7 +80,11 @@
 
 intersphinx_mapping = {
     "python": ("https://docs.python.org/3", None),
+    "matplotlib": ("https://matplotlib.org/stable", None),
+    "nibabel": ("https://nipy.org/nibabel", None),
+    "nilearn": ("https://nilearn.github.io/stable/plotting", None),
     "numpy": ("https://numpy.org/doc/1.24", None),
+    "plotly": ("https://plotly.com/python", None),
 }