hakyll-3.0.2.0: A simple static site generator library.

Hakyll.Core.Rules

Description

This module provides a declarative DSL in which the user can specify the different rules used to run the compilers.

The convention is to just list all items in the RulesM monad, routes and compilation rules.

A typical usage example would be:

 main = hakyll $ do
     route   "posts/*" (setExtension "html")
     compile "posts/*" someCompiler

Synopsis

Documentation

data RulesM a Source

The monad used to compose rules

type Rules = RulesM ()Source

Simplification of the RulesM type; usually, it will not return any result.

compile :: (Binary a, Typeable a, Writable a) => Pattern -> Compiler Resource a -> RulesSource

Add a compilation rule to the rules.

This instructs all resources matching the given pattern to be compiled using the given compiler. When no resources match the given pattern, nothing will happen. In this case, you might want to have a look at create.

create :: (Binary a, Typeable a, Writable a) => Identifier -> Compiler () a -> RulesSource

Add a compilation rule

This sets a compiler for the given identifier. No resource is needed, since we are creating the item from scratch. This is useful if you want to create a page on your site that just takes content from other items -- but has no actual content itself.

route :: Pattern -> Routes -> RulesSource

Add a route.

This adds a route for all items matching the given pattern.

metaCompileSource

Arguments

:: (Binary a, Typeable a, Writable a) 
=> Compiler () [(Identifier, Compiler () a)]

Compiler generating the other compilers

-> Rules

Resulting rules

Apart from regular compilers, one is also able to specify metacompilers. Metacompilers are a special class of compilers: they are compilers which produce other compilers.

This is needed when the list of compilers depends on something we cannot know before actually running other compilers. The most typical example is if we have a blogpost using tags.

Every post has a collection of tags. For example,

 post1: code, haskell
 post2: code, random

Now, we want to create a list of posts for every tag. We cannot write this down in our Rules DSL directly, since we don't know what tags the different posts will have -- we depend on information that will only be available when we are actually compiling the pages.

The solution is simple, using metaCompile, we can add a compiler that will parse the pages and produce the compilers needed for the different tag pages.

And indeed, we can see that the first argument to metaCompile is a Compiler which produces a list of (Identifier, Compiler) pairs. The idea is simple: metaCompile produces a list of compilers, and the corresponding identifiers.

For simple hakyll systems, it is no need for this construction. More formally, it is only needed when the content of one or more items determines which items must be rendered.

metaCompileWithSource

Arguments

:: (Binary a, Typeable a, Writable a) 
=> Identifier

Identifier for this compiler

-> Compiler () [(Identifier, Compiler () a)]

Compiler generating the other compilers

-> Rules

Resulting rules

Version of metaCompile that allows you to specify a custom identifier for the metacompiler.