Update Sphinx

Author: druzsan

.github/workflows/ci.yml

@@ -120,8 +120,7 @@ jobs:
           python-version: ${{ matrix.python-version }}
       - name: test
         run: |
-          poetry run sphinx-build docs/source build/documentation/ -W -b html
-          poetry run sphinx-build docs/source build/documentation/ -W -b doctest
+          poetry run sphinx-build docs/source build/documentation/ -W -vvv -b doctest
 
   unit-test:
     name: "🧪 Run Unit Tests"
@@ -157,7 +156,7 @@ jobs:
           python-version: "3.13"
       - name: build docs
         run: |
-          poetry run sphinx-build docs/source build/documentation/ -W -b html
+          poetry run sphinx-build docs/source build/documentation/ -W -vvv -b html
       - name: Store docs
         uses: actions/upload-artifact@v5
         with:

.tool-versions

@@ -1,2 +1,2 @@
 poetry 2.2.1
-python 3.12.10
+python 3.14.0

Makefile

@@ -39,7 +39,6 @@ check: check-format lint typecheck audit
 
 .PHONY: doctest
 doctest: ## Run doctests
-	poetry run sphinx-build docs/source build/documentation/ -W -b html
 	poetry run sphinx-build docs/source build/documentation/ -W -b doctest
 
 .PHONY: unit-test
@@ -61,7 +60,7 @@ check-wheel: wheel
 
 .PHONY: docs
 docs: ## Build documentation
-	poetry run sphinx-build docs/source build/documentation/ -W -b html
+	poetry run sphinx-build docs/source build/documentation/ -W -vvv -b html
 
 .PHONY: build
 build: ## Build all distributables

docs/source/api.rst

@@ -8,7 +8,7 @@ Mesh2VecBase
    :toctree: generated/
    :template: class.rst
 
-    mesh2vec.mesh2vec_base.Mesh2VecBase
+    mesh2vec_base.Mesh2VecBase
 
 Mesh2VecCae
 ~~~~~~~~~~~~~~~~
@@ -17,5 +17,5 @@ Mesh2VecCae
    :toctree: generated/
    :template: class.rst
 
-    mesh2vec.mesh2vec_cae.Mesh2VecCae
+    mesh2vec_cae.Mesh2VecCae
 

docs/source/conf.py

@@ -9,7 +9,6 @@
 project = "Mesh2vec"
 copyright = "2023, Renumics GmbH"
 author = "Renumics GmbH"
-from sphinx_gallery.sorting import FileNameSortKey
 
 
 # -- General configuration ---------------------------------------------------
@@ -40,7 +39,7 @@
     "gallery_dirs": [
         "generated_examples",
     ],  # path to where to save gallery generated output
-    "within_subsection_order": FileNameSortKey,
+    "within_subsection_order": "FileNameSortKey",
     "filename_pattern": "/",
     # directory where function/class granular galleries are stored
     "backreferences_dir": "generated_backreferences",
@@ -57,7 +56,7 @@
 html_static_path = ["_static"]
 
 html_theme = "sphinx_rtd_theme"
-html_theme_options = {"logo_only": True, "display_version": False}
+html_theme_options = {"logo_only": True}
 html_css_files = ["custom.css"]
 
 import plotly.io as pio

docs/source/sg_execution_times.rst

@@ -0,0 +1,49 @@
+
+:orphan:
+
+.. _sphx_glr_sg_execution_times:
+
+
+Computation times
+=================
+**00:00.000** total execution time for 5 files **from all galleries**:
+
+.. container::
+
+  .. raw:: html
+
+    <style scoped>
+    <link href="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/5.3.0/css/bootstrap.min.css" rel="stylesheet" />
+    <link href="https://cdn.datatables.net/1.13.6/css/dataTables.bootstrap5.min.css" rel="stylesheet" />
+    </style>
+    <script src="https://code.jquery.com/jquery-3.7.0.js"></script>
+    <script src="https://cdn.datatables.net/1.13.6/js/jquery.dataTables.min.js"></script>
+    <script src="https://cdn.datatables.net/1.13.6/js/dataTables.bootstrap5.min.js"></script>
+    <script type="text/javascript" class="init">
+    $(document).ready( function () {
+        $('table.sg-datatable').DataTable({order: [[1, 'desc']]});
+    } );
+    </script>
+
+  .. list-table::
+   :header-rows: 1
+   :class: table table-striped sg-datatable
+
+   * - Example
+     - Time
+     - Mem (MB)
+   * - :ref:`sphx_glr_generated_examples_aggregate_categorical.py` (``../examples/aggregate_categorical.py``)
+     - 00:00.000
+     - 0.0
+   * - :ref:`sphx_glr_generated_examples_aggregate_warpage.py` (``../examples/aggregate_warpage.py``)
+     - 00:00.000
+     - 0.0
+   * - :ref:`sphx_glr_generated_examples_plot_neighbor_distances.py` (``../examples/plot_neighbor_distances.py``)
+     - 00:00.000
+     - 0.0
+   * - :ref:`sphx_glr_generated_examples_plot_stress.py` (``../examples/plot_stress.py``)
+     - 00:00.000
+     - 0.0
+   * - :ref:`sphx_glr_generated_examples_quickstart.py` (``../examples/quickstart.py``)
+     - 00:00.000
+     - 0.0