Build presentation in docs and link to built version

Author: saulshanabrook

docs/.gitignore

@@ -2,3 +2,4 @@
 _build
 playground.ipynb
 auto_examples
+presentations

docs/conf.py

@@ -1,5 +1,28 @@
-# outline for a myst_nb project with sphinx
-# build with: sphinx-build -nW --keep-going -b html . ./_build/html
+import pathlib
+import subprocess
+
+##
+# Built presentation in sphinx
+##
+
+cwd = pathlib.Path(__file__).parent
+presentation_file = cwd / "explanation" / "pldi_2023_presentation.ipynb"
+output_dir = cwd / "presentations"
+
+subprocess.run(
+    [
+        "jupyter",
+        "nbconvert",
+        str(presentation_file),
+        "--to",
+        "slides",
+        "--output-dir",
+        str(output_dir),
+    ],
+    check=True,
+)
+
+html_extra_path = ["presentations/pldi_2023_presentation.slides.html"]
 
 # load extensions
 extensions = [

docs/explanation/pldi_2023_presentation.ipynb

@@ -11,8 +11,8 @@
     "tags": []
    },
    "source": [
-    "```bash\n",
-    "jupyter nbconvert pldi_2023_presentation.ipynb --to slides\n",
+    "```{eval-rst}\n",
+    "`Presentation as HTML <../pldi_2023_presentation.slides.html>`_\n",
     "```"
    ]
   },
@@ -27,9 +27,8 @@
     "tags": []
    },
    "source": [
-    "# `egglog` in Python...\n",
+    "# `egglog` in Python: EGRAPHS Workshop - PLDI '23\n",
     "\n",
-    "*EGRAPHS Workshop - PLDI '23*<br>\n",
     "*Saul Shanabrook*"
    ]
   },