aboutsummaryrefslogtreecommitdiff

About

This is a template site for Hakyll. It is meant to be more flexible and powerful then the default template created by Hakyll.

Structure

All inputs for Hakyll are under the src directory. The compiler directory contains the site builder and may include any other Haskell dependencies.

Usage

With Nix

Use the Nix package manager:

$ nix build -f . -o www

This will build the site and put it into the www directory (a symbolic link to a directory), ready to deploy.

Or:

$ nix build -f compiler site -o site
$ ./site/bin/site build

Manually

  1. Build the site builder: cd compiler && cabal v2-build site.
  2. Use the site builder from the top directory:
$ /path/to/site --help
Static site compiler

Usage: site [-v|--verbose] [-o|--output DIR] [-s|--source DIR] [-c|--cache DIR]
            COMMAND

Available options:
  -v,--verbose             Run in verbose mode
  -o,--output DIR          Output directory (default: "_site")
  -s,--source DIR          Source directory (default: "./src")
  -c,--cache DIR           Cache directory (default: "_cache")
  -h,--help                Show this help text

Available commands:
  build                    Build the site
  clean                    Clean
  check                    Check links


$ /path/to/site build
Initialising...
  Creating store...
  Creating provider...
  Running rules...
Checking for out-of-date items
Compiling
  updated templates/default.html
  updated about.rst
  updated templates/post.html
  updated posts/2015-08-12-spqr.markdown
  updated posts/2015-10-07-rosa-rosa-rosam.markdown
  updated posts/2015-11-28-carpe-diem.markdown
  updated posts/2015-12-07-tu-quoque.markdown
  updated templates/archive.html
  updated templates/post-list.html
  updated archive.html
  updated contact.markdown
  updated css/default.css
  updated images/haskell-logo.png
  updated index.html
Success