Fork me on GitHub

Tutorial: Installation

Installation

Installation is provided via Hackage, and some packages are available for different distributions. There are a few different methods to install Hakyll.

  1. You can use ghcup to install Cabal and then use:

    $ cabal new-install hakyll
  2. Using stack:

    $ stack install hakyll
  3. There are also some Linux distro packages:

Building the example site

Apart from the main Hakyll library, the package also provides you with an executable hakyll-init to create an example site. This is an easy way to get started.

Using cabal

Create the example site:

hakyll-init my-site

If hakyll-init is not found, make sure ~/.ghcup/env is sourced.

In the my-site directory, you can use cabal new-install to install the site executable (which builds your website). Alternatively, you can just use cabal new-run site [command].

You can build the site using:

site build

And preview (and build) it using:

site watch

Using stack

Create the my-site directory with the project files inside:

$ stack exec hakyll-init my-site

Now, change into my-site directory and create a file stack.yaml here with the following content:

resolver: lts-14.16  # Adapt this as needed
packages:
  - .
extra-deps:
  - hakyll-4.13.0.1  # Or a later version you installed

On NixOS you will probably have to add the following lines to this file:

nix:
  enable: true
  packages: [zlib.dev, zlib.out]

The file site.hs holds the configuration of your site, as an executable haskell program. We can compile and run it like this:

$ stack build
$ stack exec site build

If you installed hakyll with a preview server (this is the default), you can now use:

$ stack exec site watch

and have a look at your site at http://localhost:8000/.

Other tutorials

The other tutorials can be found here.

Documentation inaccurate or out-of-date? Found a typo?

Hakyll is an open source project, and one of the hardest parts is writing correct, up-to-date, and understandable documentation. Therefore, the authors would really appreciate it if you would give feedback about the tutorials, and especially report errors or difficulties you encountered. If you have a github account, you can use the issue system. Thanks! If you run into any problems, all questions are welcome in the above google group, or you could try the IRC channel, #hakyll on irc.libera.chat (we do not have a channel on Freenode anymore).