If you found this repo looking for cool things to "borrow", feel free; I'd recommend looking at the commits which improved the site rather than the site.hs as a whole.

I've added onto site.hs which the default does have include:

• Tags, Categories for posts.

• Pagination and Teaser text. This was done slightly differently from Hakyll's in-built pagination/teasers.

• Next/Previous Post links in the post.

The following environment variables can be set, corresponding to the similarly named options in Hakyll's Configuration:

• HAKYLL_DESTINATION_DIRECTORY
• HAKYLL_STORE_DIRECTORY
• HAKYLL_TMP_DIRECTORY
• HAKYLL_PROVIDER_DIRECTORY
• HAKYLL_DEPLOY_COMMAND
• HAKYLL_IN_MEMORY_CACHE
• HAKYLL_PREVIEW_HOST
• HAKYLL_PREVIEW_PORT

A default value will be used for the configuration option if it is not set.

• Posts: the content of posts/ is a tree of files named:

posts/<category>/YYYY-MM-DD-title.markdown

• Pages: the content of pages/ is a list of files.

• Static Assets: under js/, images/, css/ directory.

• Templates:

  • templates/default.html (which embeds a $body$, used by all the web pages).
  • templates/page-body.html (body for the pages/).
  • templates/paginated_previews-body.html (body for "paginated previews")
  • templates/post-body.html (body for a blog post)
  • templates/post_list-body.html (body for "post list", e.g. archives, posts with some tag)
  • templates/teaser.html (the template rendered for paginated_previews-body's $posts$ field).

• Webpages generated dynamically:

  • atom.xml :: RSS feed of posts with title.
  • archive.html :: List of posts with title.
  • categories/<category>.html, tags/<tag>.html :: Pages with lists of posts with that category/tag.
  • index.html, <page>/index.html :: Paginated previews of blogposts.

With nix installed, this hakyll static site generator can be run in a nix-shell. e.g. if shell.nix has contents:

{ pkgs ? import <nixpkgs> {} }:
with pkgs;
let
  my-hakyll-blog = callPackage (fetchFromGitHub {
      owner = "rgoulter";
      repo = "my-hakyll-blog";
      rev = "a3962299f14944a0e9ccf8fd84bd7be524b74cd6";
      sha256 = "06p69fwk6v8hgwhr37rl3qlbpdx8mv66dngpljzichh2ak35x9nm";
    }) {};
in
mkShell {
  buildInputs = [
    my-hakyll-blog
  ];
}

Then, the my-hakyll-blog program will be available from nix-shell.

The benefit of this approach is it avoids requiring manually cloning and building the static site generator.

With nix installed, this hakyll static site generator can be built by running:

nix-build

and the resulting program can be run from result/bin, e.g.:

./result/bin/my-hakyll-blog build

To build the site with the provider-example.com sample content:

env \
  HAKYLL_PROVIDER_DIRECTORY="provider-example.com" \
  ./result/bin/my-hakyll-blog build

If you want the program installed to your Nix user environment, run:

nix-env --install --file default.nix

And this can be uninstalled with:

nix-env --uninstall my-hakyll-blog

Using stack, the program can be run with e.g.:

stack run -- build

Alternatively, the program can be built with:

stack build

Then the hakyll site executable can be exec'd using stack, e.g.:

stack exec my-hakyll-blog -- build

Using nix to retrieve the GHC version:

e.g. to run the build Hakyll command:

stack --nix --nix-shell-file=stack-shell.nix run -- build

To build the site with the provider-example.com sample content:

stack --nix --nix-shell-file=example.com-shell.nix run -- build

cf. https://stackoverflow.com/questions/27616611/run-time-exception-when-attempting-to-print-a-unicode-character

It's best to run:

chcp.com 65001