adapt doc to new format.

Author: paquiteau

docs/source/conf.py

@@ -21,9 +21,6 @@
 copyright = f"2020, {author}"
 gh_user = "sfarrens"
 
-# If your documentation needs a minimal Sphinx version, state it here.
-needs_sphinx = "3.3"
-
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
@@ -38,7 +35,7 @@
     "sphinx.ext.napoleon",
     "sphinx.ext.todo",
     "sphinx.ext.viewcode",
-    "sphinxawesome_theme",
+    "sphinxawesome_theme.highlighting",
     "sphinxcontrib.bibtex",
     "myst_parser",
     "nbsphinx",
@@ -103,7 +100,7 @@
 }
 html_collapsible_definitions = True
 html_awesome_headerlinks = True
-html_logo = "modopt_logo.jpg"
+html_logo = "modopt_logo.png"
 html_permalinks_icon = (
     '<svg xmlns="http://www.w3.org/2000/svg" '
     'viewBox="0 0 24 24">'
@@ -148,7 +145,7 @@
 # -- Options for Sphinx Gallery ----------------------------------------------
 
 sphinx_gallery_conf = {
-    "examples_dirs": ["../../modopt/examples/"],
+    "examples_dirs": ["../../examples/"],
     "filename_pattern": "/example_",
     "ignore_pattern": r"/(__init__|conftest)\.py",
 }

examples/example_lasso_forward_backward.py

@@ -132,6 +132,7 @@
 #
 # sphinx_gallery_start_ignore
 assert mse(fb_pogm.x_final, BETA_TRUE) < 1
+# sphinx_gallery_end_ignore
 
 # %%
 # Comparing the Two algorithms

pyproject.toml

@@ -15,11 +15,11 @@ dependencies = ["numpy", "scipy", "tqdm", "importlib_metadata"]
 
 [project.optional-dependencies]
 gpu=["torch", "ptwt"]
-doc=["myst-parser==0.16.1",
-"nbsphinx==0.8.7",
-"nbsphinx-link==1.3.0",
-"sphinx-gallery==0.11.1",
-"sphinxawesome-theme==3.2.1",
+doc=["myst-parser",
+"nbsphinx",
+"nbsphinx-link",
+"sphinx-gallery",
+"sphinxawesome-theme",
 "sphinxcontrib-bibtex"]
 dev=["black", "ruff"]
 test=["pytest<8.0.0", "pytest-cases", "pytest-cov", "pytest-xdist", "pytest-sugar"]