Additions to Hakyll

Posted on June 30, 2014 by Richard Goulter
Tags: ,

The basic Hakyll site is (thankfully) not too glamorous. Some features I wanted to keep from WordPress include the tags, categories, pagination of posts, and ‘teaser’ text for each post.

The repository for this site is at rgoulter/my-hakyll-blog if you want to see the actual commits.


Doing a Google search for “hakyll tags” probably will lead you to the same tutorial I found. But you found yourself here, so I’ll point out I used this tutorial


The haddock documention for Hakyll.Web.Tags describes that i. “Categories” are a special kind of “tag”; the only difference being a post can only belong to one category, but can have any number of tags. ii. Hakyll determines a category for a post (by default) using the directory structure. e.g.: posts/<category>/1970-01-01-a-post.markdown has the category <category>.

If you’ve a reasonable idea of how you get from the tags, to the context, to the produced HTML, then it should be fairly clear how to add categories.
Here’s the commit where I make the changes. The trickiest part was that the Glob needed to be “posts/**.markdown” to match posts.

Pagination and Teasers

These come hand in hand if you “adapt” from the same sites I did.
The literate-haskell of EAnalytica’s site has pretty candid comments discussing the Haskell it uses. In turn, EAnalytica also borrows from Danny Su’s site, which is also useful for this.
The easiest way to ‘adapt’ from these was to look first at EAnalytica’s, then at Danny Su’s. (The limitation of Danny Su’s site is the site’s pagination is only 2 posts per page, and the rule for pagination relies on that, unfortunately). The more tedious part (unless you’ve got good control over your Haskell editor) is getting the imports for the necessary utility functions.

One thing which tripped me up was that the code from these sites has magic strings for the Posts pattern, and for the pagination URL. (c.f.).

For a more direct indication of the code to incorporate, this is the commit where my blog adds pagination and teasers.

Newer post Older post