hakyll/web/tutorials/01-installation.markdown
2013-02-10 11:05:37 +01:00

1.3 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 provided 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.

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/.