Jupyter notebooks

Convert and publish reproducible notebook output.

Jupyter notebooks combine prose, executable code, and output in .ipynb JSON files. The theme converts them before Hugo builds, so the published page contains ordinary Markdown and images rather than executable code.

Build-time notebook output#

This preview represents Markdown produced by the pinned nbconvert workflow. A real notebook can include narrative cells, highlighted input and tabular output.

analysis.ipynb · cell 1

pages = 98
languages = ["English", "Deutsch", "Français"]
pages_per_language = pages / len(languages)
pages_per_language

output

32.67

Language	Published
English	yes
Deutsch	yes
Français	yes

{{< notebook "theme-demo" >}}

Create an isolated conversion environment and convert every notebook:

python3 -m venv .venv
. .venv/bin/activate
pip install -r scripts/requirements.txt
./scripts/notebooks.sh

The pinned nbconvert environment makes conversion reproducible and keeps the tools outside the system Python installation. Embed the converted result with {{< notebook "theme-demo" >}}. The shortcode accepts a converted file; it cannot execute or contain an inline notebook. See Notebook conversion for lookup paths.