$\DeclareMathOperator{\homop}{Hom} \newcommand{\Hom}[2]{\homop\left(#1,\,#2\right)} \newcommand{\lt}{<} \newcommand{\gt}{>} \newcommand{\amp}{&} \definecolor{fillinmathshade}{gray}{0.9} \newcommand{\fillinmath}[1]{\mathchoice{\colorbox{fillinmathshade}{$\displaystyle \phantom{\,#1\,}$}}{\colorbox{fillinmathshade}{$\textstyle \phantom{\,#1\,}$}}{\colorbox{fillinmathshade}{$\scriptstyle \phantom{\,#1\,}$}}{\colorbox{fillinmathshade}{$\scriptscriptstyle\phantom{\,#1\,}$}}} $

Section 35.1 Building Notebooks

The pretext/pretext script has two formats for the conversion.

pretext/pretext -c doc -f jupyter -p publication.xml -d output/jupyter source.xml
pretext/pretext -c doc -f jupyter-zip -p publication.xml -d output/jupyter source.xml

Every notebook is validated against the official notebook schema as it is built, so a completed build is a well-formed one. Images from your managed directories are copied alongside the notebooks, so the output is complete and portable: give a reader the whole directory, or serve it from a JupyterHub, or drop it into CoCalc. The jupyter-zip format produces the same collection bundled as a single zip file, convenient to pass along.

The Python that runs the conversion needs the small nbformat package, which is listed in the script’s requirements.

Prev Top Next