Posts from March 2022

  • Single Sourcing My Cookbook

    Part one of two on single sourcing content to produce multiple attractive outputs. In this case, a write-up about the creation of my personal cookbook!

    Note: This was originally going to be a single post about both my Cookbook and my CV, but it turns out I can really ramble, so I’m splitting it into two posts.

    One of the benefits of using a static site generator (in my case Jekyll) to build this website is that all the underlying content is stored in simple text files. Most of the page content itself is just markdown files with a YAML header block. The page layout is simple HTML templates using liquid macros. Formatting is SASS that’s transformed into vanilla CSS.

    This has a few of benefits. First, the site is future-proofed–plain text means I can move to a different engine any time I want, as the content is stored in a format that’s easy to extract and transform. Second, the ecosystem of tools to handle text files generally, and YAML and markdown specifically, is enormous, which means I can lean on all that existing infrastructure to do interesting things.

    In this post I’ll cover the first of two examples where I’ve taken advantage of these benefits to produce, not just this website, but beautiful PDFs, ebooks, and even Word documents, from the same source content.

    Continue reading...