4 ms·
meta comment: the website you're viewing when you click that link is generated using Jupyter Book , which is like the best thing ever https://jupyterbook.org/in
by ivan_ah 5y ago
meta comment: the website you're viewing when you click that link is generated using Jupyter Book , which is like the best thing ever https://jupyterbook.org/intro.html https://jupyterbook.org/intro.html
Imagine all the beauty of .Rmd (easily generate books by combining markdown explanations with executable cells), but adapted for the Python ecosystem (jupyter notebooks).
Jupyuter-book is a really well thought-out project. You create the book with a _toc.yml file:
https://github.com/tum-pbs/pbdl-book/blob/main/_toc.yml https://github.com/tum-pbs/pbdl-book/blob/main/_toc.yml and all the config is in one file: https://github.com/tum-pbs/pbdl-book/blob/main/_config.yml https://github.com/tum-pbs/pbdl-book/blob/main/_config.yml (the build system leverages Sphinx which is the docs workhorse in the Python world)
One of the coolest things is the "Launcher" option which gives readers the options to "run" any notebook interactively (using the rocket button in the top right). It's a one-line config https://github.com/tum-pbs/pbdl-book/blob/main/_config.yml#L10-L12 https://github.com/tum-pbs/pbdl-book/blob/main/_config.yml#L... A similar config would enable the "Launch in Pybinder" option which is a free ephemeral jupyter provider, see https://mybinder.org/ https://mybinder.org/
This "execute anywhere" option is nicely abstracted away as the `thiebe` library, and there is even POC work to run a pyodide kernel (https://github.com/executablebooks/thebe/issues/465 https://github.com/executablebooks/thebe/issues/465) so soon all of this goodness will work offline in your browser!
As an educator, it's hard not to get excited about the future, given the pace at which learning/teaching tooling is developing!
- ngcc_hk 5y agoNeed another thread on this. It is a major learning tool when I first encountered Jupyter.