Skip to content

Commit

Permalink
Thebe: demonstrate Thebe to run code inline
Browse files Browse the repository at this point in the history
- 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.
  • Loading branch information
rkdarst committed Nov 5, 2023
1 parent fe61dcf commit f087ae2
Show file tree
Hide file tree
Showing 3 changed files with 10 additions and 0 deletions.
7 changes: 7 additions & 0 deletions content/conf.py
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
2 changes: 2 additions & 0 deletions content/pandas.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
1 change: 1 addition & 0 deletions requirements.txt
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down

0 comments on commit f087ae2

Please sign in to comment.