Most static site generators usually have a set of template HTML files that are filled with posts index, post contents and other stuff, but Haunt is a bit different, as it provides its own template language that in turn will generate the HTML code. The DSL reminds me a bit Hiccup, just replace vectors with lists and keywords with symbols and the two are basically the same...if we don't focus too much on the details.
This is the first time I am using Haunt and I had to do a bit of digging to figure out how to add the tracking script. Fortunately there are plenty of examples, starting from the project's documentation sources, where it is possible to see how the author is embedding piwik analytics in the project's website.
Other site built with Haunt (together with sources) are listed here.
Haunt expects a configuration file called haunt.scm, with the settings of the site like domain name, site title, where to find the source posts etc in order to be able to build the final site. Part of the settings are which readers to use, for example CommonMark, or builders such as blog, feeds, static assets etc.
Each builder is customizable and the
blog builder accept a
#:theme parameter where it is
possible to provide a custom theme; when not specified the builtin
ugly-theme is used.
The theme is declared using the
theme function that accepts the following parameters:
Fortunately each parameter is optional so, to just customize the general layout to include the script for the tracking code, it is enough to create a new function, overriding the base layout function, to include the custom code and that's it! Ez Pz
Here is my current custom theme in all its glory
It is entertaining to play with new tools, sometimes we expect them to work in a certain way and it can be frustrating if they don't but, if we spend enough time trying to get to understand them, then we can learn something new and even have some fun time!