hakyll/web/tutorials/01-installation.markdown
2013-04-29 09:03:57 -04:00

1.5 KiB

title author
Installation Jasper Van der Jeugt

Installation

Installation is provided using cabal, and some packages are available for different distributions.

$ cabal install hakyll

If you have a recent installation of cabal and your time is somewhat valuable, use:

$ cabal install -j hakyll

Linux distro packages:

Building the example site

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

$ hakyll-init my-site

This creates a folder my-site in the current directory, with some example content and a generic configuration.

If hakyll-init is not found, you should make sure $HOME/.cabal/bin is in your $PATH. (If you're on OS X, you may not have a bin directory in $HOME/.cabal. In this case, check $HOME/Library/Haskell/bin and put it on your path if you find hakyll-init there.)

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

$ cd my-site
$ ghc --make site.hs
$ ./site build

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

$ ./site preview

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