Notebook.sh

The Exploratory Programming textbook written by Nick Monfort suggests to get paper in the room when learning to do programming, which was a trigger to start producing printed notebooks for the prototyping classes.

This year, I'm curious to explore ways to generate these notebooks from the wiki, and hook into one of the habits and rhythms at the course that is quite central: wiki editing.

Publishing the code and stylesheet (as executable CSS) on the wiki hooks into these habits. As a form of literate programming, it lets code resonate with the wiki environment while storing code as a document and not "just" a script.

The script below uses curl, pandoc, weasyprint, pdfbook2 and Notebook-stylesheet.css as a stylesheet to render a PDF from a wiki page.

You can copy the script and save it as a local bash file, for example: notebook.sh.

And run it with: $ bash notebook.sh WIKIPAGE, for example: $ bash notebook.sh Pen_plotters

Note that you should use underscores and not spaces in the wiki pagename!

#!/bin/bash

# Capturing the wiki page
# ---------------------------------------------------------------
# the wiki page that you wrote as an argument in the command line, 
# is stored in this variable
WIKIPAGE=$1
echo ">>> making a notebook from the wiki page: $WIKIPAGE"

# Feature: local CSS edits first!
# ---------------------------------------------------------------
# The script will only download a local "notebook-stylesheet.css"
# if you don't have this file on your computer yet;
# In other words: it never overwrites your local edits.
# This allows for making custom modifications to the stylesheet
# for a specific notebook. :)
if [[ $(ls notebook-stylesheet.css) ]]; then
        echo ">>> local notebook-sylesheet.css found"
else
        echo ">>> downloading notebook-sylesheet.css"
        curl --silent  https://pzwiki.wdka.nl/mediadesign/Notebook-stylesheet.css?action=raw > notebook-stylesheet.css
fi

curl --silent  https://pzwiki.wdka.nl/mediadesign/Notebook-stylesheet.css?action=raw > notebook-stylesheet.css.tmp

DIFF=$(diff notebook-stylesheet.css.tmp notebook-stylesheet.css)
if [[ $DIFF ]]; then
        echo ">>> checking notebook-sylesheet.css: local edits were made"
else
        echo ">>> checking notebook-sylesheet.css: in sync with the wiki page Notebook-stylesheet.css"
fi

rm notebook-stylesheet.css.tmp

# Turn the HTML page into a PDF with weasyprint
# ---------------------------------------------------------------
PDFNAME=$(echo "$WIKIPAGE" | tr :/#%{}\&\\\<\>*?/\!\'\"@+\`= _)
echo ">>> generating $PDFNAME.pdf (with weasyprint)"
weasyprint https://pzwiki.wdka.nl/mediadesign/$WIKIPAGE?action=render --stylesheet notebook-stylesheet.css $PDFNAME.pdf

# And turn the PDF into an A5 booklet PDF for printing
# ---------------------------------------------------------------
# pdfbook2 is part of the texlive-extra-utils package in Debian
echo ">>> generating $PDFNAME-book.pdf (with pdfbook2)"
pdfbook2 --paper=a4paper --short-edge --no-crop $PDFNAME.pdf

This script is used to make: