Docs: Fix the build on ReadTheDocs

There was a backtick missing in the `help` attribute of an input port
declaration of the `CalcJob` class. This class is rendered automatically
through our sphinx plugin in the `topics/calculations/usage.rst` file in
the "Options" section. No idea why this didn't fail before this because
this mistake was not introduced in this PR.

Also add config option for `myst-nb` to `conf.py` so that it shows the
stacktrace if an exception is raised during notebook execution.

aiida/engine/processes/calcjobs/calcjob.py

@@ -418,7 +418,7 @@ def define(cls, spec: CalcJobProcessSpec) -> None:  # type: ignore[override]
             'metadata.options.stash.stash_mode',
             valid_type=str,
             required=False,
-            help='Mode with which to perform the stashing, should be value of `aiida.common.datastructures.StashMode.'
+            help='Mode with which to perform the stashing, should be value of `aiida.common.datastructures.StashMode`.'
         )
 
         spec.output(

docs/source/conf.py

@@ -83,6 +83,7 @@
 
 myst_enable_extensions = ['colon_fence', 'deflist']
 myst_heading_anchors = 3
+nb_execution_show_tb = 'READTHEDOCS' in os.environ
 nb_merge_streams = True
 nb_mime_priority_overrides = [
     ('gettext', 'application/vnd.jupyter.widget-view+json', 0),

docs/source/intro/tutorial.md

@@ -226,7 +226,7 @@ $ verdi node graph generate 3
 
 The command will write the provenance graph to a `.pdf` file.
 Use your favorite PDF viewer to have a look.
-It should look something like the graph shown {ref}`below <fig_calcfun_graph>`.
+It should look something like the graph shown below.
 
 ```{code-cell} ipython3
 ---

docs/source/nitpick-exceptions

@@ -121,6 +121,7 @@ py:class requests.models.Response
 py:class requests.Response
 
 py:class concurrent.futures._base.TimeoutError
+py:class concurrent.futures._base.Future
 
 py:class disk_objectstore.utils.LazyOpener