Thebe: demonstrate Thebe to run code inline

- Don't merge: this is a demo.
  - This includes the Pandas pull request, but is unrelated.  Diff
    will look better once that is merged.
- A "Launch" button appears at the top
- Then, it launches a kernel on mybinder.org in the default jupyter
  data sci repo (todo: does this have everything this course needs?).
- Then, you can click "run" on any cell and see the output (just like
  Jupyter would look), also edit the code and re-run.
- Formatting is a bit off (line spacing is too much, probably since
  this uses sphinx_rtd_theme).
- I don't think we should use this for 2023 (not unless there is more
  testing and maybe an own mybinder instance...), but hopefully it's a
  good demo.

Author: rkdarst

content/conf.py

@@ -40,9 +40,16 @@
     'sphinx.ext.mathjax',
     'sphinx_aaltoscicomp_branding',
     'sphinxext.opengraph',
+    'sphinx_thebe',
 ]
 myst_enable_extensions = ['colon_fence']
 
+thebe_config = {
+   "selector": "div.highlight"
+}
+
+nb_execution_mode = "off"
+
 ogp_site_name = "Python for Scientific Computing"
 ogp_site_url = 'https://aaltoscicomp.github.io/python-for-scicomp/'
 import datetime

content/pandas.rst

@@ -33,6 +33,8 @@ material, including:
 A quick Pandas preview
 ----------------------
 
+.. thebe-button::
+
 Let's get a flavor of what we can do with pandas (you won't be able to follow everything yet). We will be working with an example dataset containing the passenger list from the Titanic, which is often used in Kaggle competitions and data science tutorials. First step is to load pandas::
 
     import pandas as pd

requirements.txt

@@ -6,6 +6,7 @@ sphinx-lesson
 https://github.com/aaltoscicomp/sphinx-aaltoscicomp-branding/archive/master.zip
 sphinx_rtd_theme_ext_color_contrast
 sphinxext-opengraph
+sphinx-thebe
 
 # for web-apis execution
 jsonlines