Add example that illustrates how to use submeshes with DOLFINx-adjoint

.github/workflows/build_docs.yml

@@ -3,7 +3,7 @@ name: Build documentation
 on:
   push:
     branches:
-    - "**"
+      - "**"
   workflow_call:
   workflow_dispatch:
 
@@ -13,9 +13,9 @@ env:
   PYVISTA_JUPYTER_BACKEND: "html"
   LIBGL_ALWAYS_SOFTWARE: 1
   DISPLAY: ":99.0"
+  PIP_NO_BUILD_ISOLATION: 0
 
 jobs:
-
   build:
     runs-on: ubuntu-latest
     container: ghcr.io/fenics/dolfinx/lab:nightly
@@ -33,10 +33,10 @@ jobs:
       - name: Install dependencies
         run: |
           python3 -m pip install git+https://github.com/funsim/moola.git
-          python3 -m pip install ".[docs]" --no-build-isolation
+          python3 -m pip install ".[docs]"
 
       - name: Build docs
-        run: jupyter book build -W .
+        run: jupyter book build .
 
       - name: Upload artifact
         uses: actions/upload-artifact@v7

.github/workflows/test_package.yml

@@ -19,24 +19,21 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        label: [
-          "stable",
-          "nightly"
-        ]
+        label: ["stable", "nightly"]
 
     env:
       OMPI_ALLOW_RUN_AS_ROOT: 1
       OMPI_ALLOW_RUN_AS_ROOT_CONFIRM: 1
       PRTE_MCA_rmaps_default_mapping_policy: :oversubscribe
+      PIP_NO_BUILD_ISOLATION: 0
     steps:
       - uses: actions/checkout@v7
 
       - name: Install package
-        run: python3 -m pip install .[test] --no-build-isolation
+        run: python3 -m pip install .[test]
 
       - name: Run tests
         run: python3 -m pytest -vs .
 
-
       - name: Run tests parallel
         run: mpirun -n 2 python3 -m pytest -vs tests/

_config.yml

@@ -41,9 +41,24 @@ sphinx:
       .py:
         - jupytext.reads
         - fmt: py
+    suppress_warnings: ["mystnb.unknown_mime_type"]
+    codeautolink_concat_default: True
+    intersphinx_mapping:
+      basix : ["https://docs.fenicsproject.org/basix/main/python/", null]
+      ffcx : ["https://docs.fenicsproject.org/ffcx/main/", null]
+      ufl : ["https://docs.fenicsproject.org/ufl/main/", null]
+      dolfinx : ["https://docs.fenicsproject.org/dolfinx/main/python/", null]
+      scifem: ["http://scientificcomputing.github.io/scifem/", null]
+      petsc4py: ["https://petsc.org/release/petsc4py/", null]
+      mpi4py: ["https://mpi4py.readthedocs.io/en/stable", null]
+      numpy: ["https://numpy.org/doc/stable/", null]
+      pyvista: ["https://docs.pyvista.org/", null]
+      packaging: ["https://packaging.pypa.io/en/stable/", null]
 
   extra_extensions:
   - 'sphinx.ext.autodoc'
   - 'sphinx.ext.napoleon'
   - 'sphinx.ext.viewcode'
+  - 'sphinx.ext.intersphinx'
+  - 'sphinx_codeautolink'
 exclude_patterns: [".pytest_cache/*"]

_toc.yml

@@ -7,6 +7,7 @@ parts:
     - file: "demos/poisson_mother.py"
     - file: "demos/time_distributed_control.py"
     - file: "demos/demo_nonmatching_grids.py"
+    - file: "demos/emi_membrane_current_control.py"
   - caption: Python API
     chapters:
     - file: "docs/api"