docs: add id-field and import to nbexport

- Adds `id` field to exported notebooks. For more information see: https://jupyter.org/enhancement-proposals/62-cell-id/cell-id.html
- Import specific exception directly from `nbclient` as a workaround for `nbconvert` not importing it anymore since jupyter/nbconvert@a7df9af .

docs/_ext/nbexport.py

@@ -1,4 +1,5 @@
 import os
+import uuid
 import itertools
 import mimetypes
 import posixpath
@@ -7,9 +8,13 @@
 import nbformat
 from sphinx import roles, addnodes
 from docutils import nodes, writers
+from nbclient.exceptions import CellExecutionError
 from docutils.parsers.rst import directives
 from nbconvert.preprocessors import ExecutePreprocessor
-from nbconvert.preprocessors.execute import CellExecutionError
+
+
+def _cell_uuid():
+    return uuid.uuid4().hex[:8]
 
 
 def _finalize_markdown_cells(nb):
@@ -92,7 +97,14 @@ def __init__(self, document, app, docpath):
     def write_markdown(self, text):
         if self.nb.cells[-1].cell_type != "markdown":
             self.nb.cells.append(
-                nbformat.from_dict({"cell_type": "markdown", "metadata": {}, "source": []})
+                nbformat.from_dict(
+                    {
+                        "cell_type": "markdown",
+                        "metadata": {},
+                        "source": [],
+                        "id": _cell_uuid(),
+                    }
+                )
             )
 
         self.nb.cells[-1].source.append(text.replace("\n", "\n" + " " * self.indent))
@@ -117,6 +129,7 @@ def add_codecell(self, code):
                     "metadata": {},
                     "source": code.strip(),
                     "outputs": [],
+                    "id": _cell_uuid(),
                 }
             )
         )

docs/requirements.txt

@@ -1,5 +1,6 @@
 sphinx_lfs_content==1.0.0
 matplotlib
+nbclient>=0.5.0
 nbconvert
 nbformat
 numpy