1.7 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. See here for more information on
installation paths on OS X.)
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/.