The generation of my personal website is far from being trivial, and requires a
combination of —probably too— many tools. It turned out that some choices I have
made early on gave to the build toolchain I ended up writing a pretty nice
property: I could easily integrate its code to the very website it was conceived
to build, by means of literate programming!
The document you are reading is just that: the literate program of my home-grown
build toolchain —called cleopatra—. The motivations behind this name are
My main objective when I started working on this “project” was to be able to
easily use whatever format I wanted to author my contents. Did you know that
Cleopatra was a reputed polyglot (at least according to Wikipedia France)?
cleopatra is a literate program whose “program” part is working as
expected. Its “literate” part still requires some work, though.
soupault is a HTML processor, and it can be used as a static website
generator. This is the approach used for this very website, and this document
is the literate program of the dedicated cleopatra generation process.