2009-12-29 18:26:51 +00:00
|
|
|
---
|
|
|
|
title: Home
|
|
|
|
---
|
|
|
|
|
2011-06-13 16:26:04 +00:00
|
|
|
# Overview
|
2009-12-29 18:26:51 +00:00
|
|
|
|
2012-12-14 09:42:30 +00:00
|
|
|
Static sites are fast, secure, easy to deploy, and manageable using version
|
|
|
|
control.
|
|
|
|
|
2010-02-27 16:24:28 +00:00
|
|
|
Hakyll is a [Haskell](http://haskell.org) library for generating static sites,
|
|
|
|
mostly aimed at small-to-medium sites and personal blogs. It is written in a
|
|
|
|
very configurable way and uses an [xmonad](http://xmonad.org)-like DSL for
|
|
|
|
configuration.
|
2009-12-29 18:26:51 +00:00
|
|
|
|
2011-05-29 09:43:54 +00:00
|
|
|
Integration with [pandoc](http://johnmacfarlane.net/pandoc/) gives us markdown
|
|
|
|
and TeX support, including syntax highlighting and other goodies.
|
|
|
|
|
2011-06-13 16:26:04 +00:00
|
|
|
# The Hakyll System
|
2009-12-29 18:26:51 +00:00
|
|
|
|
2011-06-13 16:26:04 +00:00
|
|
|
## Write your content in whatever format you prefer
|
2009-12-29 18:26:51 +00:00
|
|
|
|
2011-05-29 09:43:54 +00:00
|
|
|
![Write your content](/images/hakyll-system-1.png)
|
2009-12-29 18:26:51 +00:00
|
|
|
|
2011-06-13 16:26:04 +00:00
|
|
|
## Create compilation rules in a Haskell EDSL
|
2009-12-29 18:26:51 +00:00
|
|
|
|
2011-05-29 09:43:54 +00:00
|
|
|
![Write your rules](/images/hakyll-system-2.png)
|
2010-04-04 12:39:01 +00:00
|
|
|
|
2011-06-13 16:26:04 +00:00
|
|
|
## Compile it to HTML and upload it!
|
2010-04-04 12:39:01 +00:00
|
|
|
|
2011-05-29 09:43:54 +00:00
|
|
|
![Compile it](/images/hakyll-system-3.png)
|
|
|
|
|
2011-06-13 16:26:04 +00:00
|
|
|
# Getting Started
|
2009-12-29 18:26:51 +00:00
|
|
|
|
2011-03-01 13:47:33 +00:00
|
|
|
You can get the latest version from hackage using `cabal install hakyll`. Then,
|
|
|
|
you can:
|
|
|
|
|
2011-06-13 16:26:04 +00:00
|
|
|
- read the [tutorials](/tutorials.html);
|
2011-03-01 13:47:33 +00:00
|
|
|
- mail the [google discussion group](http://groups.google.com/group/hakyll);
|
|
|
|
- ask questions on the IRC channel: `#hakyll` on
|
|
|
|
[freenode](http://freenode.net/).
|