$\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.

You have attempted of activities on this page.

Prev Top Next