Skip to main content

Introduction

A Jupyter notebook is a document, rendered in a web browser, that mixes formatted text with programming code that a reader can execute, edit, and execute again. For a book with <sage> elements this is an attractive format: the narrative reads like the HTML version, while every piece of Sage code becomes live. This conversion produces a collection of notebooks, one for each “page” that the online version would have, in the standard ipynb format that Jupyter, JupyterLab, CoCalc, and similar applications all read.
The text cells are built with the same machinery as the online version, so many of the publication file options for HTML (Section 44.5) carry over to a Jupyter build. The options below are the notebook-specific ones.
The conversion is experimental and incomplete. Exotic constructions may be missing or may render as static placeholders, and a build will announce this. But narrative, mathematics, images, tables, worksheets, and executable Sage code all translate well.