hakyll-4.7.5.1: A static website compiler library

Safe Haskell | None
Language | Haskell98

Hakyll.Core.Compiler

Synopsis

- data Compiler a
- getUnderlying :: Compiler Identifier
- getUnderlyingExtension :: Compiler String
- makeItem :: a -> Compiler (Item a)
- getRoute :: Identifier -> Compiler (Maybe FilePath)
- getResourceBody :: Compiler (Item String)
- getResourceString :: Compiler (Item String)
- getResourceLBS :: Compiler (Item ByteString)
- getResourceFilePath :: Compiler FilePath
- type Snapshot = String
- saveSnapshot :: (Binary a, Typeable a) => Snapshot -> Item a -> Compiler (Item a)
- load :: (Binary a, Typeable a) => Identifier -> Compiler (Item a)
- loadSnapshot :: (Binary a, Typeable a) => Identifier -> Snapshot -> Compiler (Item a)
- loadBody :: (Binary a, Typeable a) => Identifier -> Compiler a
- loadSnapshotBody :: (Binary a, Typeable a) => Identifier -> Snapshot -> Compiler a
- loadAll :: (Binary a, Typeable a) => Pattern -> Compiler [Item a]
- loadAllSnapshots :: (Binary a, Typeable a) => Pattern -> Snapshot -> Compiler [Item a]
- cached :: (Binary a, Typeable a) => String -> Compiler a -> Compiler a
- unsafeCompiler :: IO a -> Compiler a
- debugCompiler :: String -> Compiler ()

# Documentation

data Compiler a Source

A monad which lets you compile items and takes care of dependency tracking for you.

Instances

Monad Compiler Source |
Functor Compiler Source |
Applicative Compiler Source |
Alternative Compiler Source |
MonadMetadata Compiler Source |
MonadError [String] Compiler Source |

getUnderlying :: Compiler Identifier Source

Get the underlying identifier.

getUnderlyingExtension :: Compiler String Source

Get the extension of the underlying identifier. Returns something like `".html"`

makeItem :: a -> Compiler (Item a) Source

getRoute :: Identifier -> Compiler (Maybe FilePath) Source

Get the route for a specified item

getResourceBody :: Compiler (Item String) Source

Get the full contents of the matched source file as a string, but without metadata preamble, if there was one.

getResourceString :: Compiler (Item String) Source

Get the full contents of the matched source file as a string.

getResourceLBS :: Compiler (Item ByteString) Source

Get the full contents of the matched source file as a lazy bytestring.

getResourceFilePath :: Compiler FilePath Source

Get the file path of the resource we are compiling

type Snapshot = String Source

Whilst compiling an item, it possible to save multiple snapshots of it, and not just the final result.

saveSnapshot :: (Binary a, Typeable a) => Snapshot -> Item a -> Compiler (Item a) Source

Save a snapshot of the item. This function returns the same item, which convenient for building `>>=` chains.

load :: (Binary a, Typeable a) => Identifier -> Compiler (Item a) Source

Load an item compiled elsewhere. If the required item is not yet compiled, the build system will take care of that automatically.

loadSnapshot :: (Binary a, Typeable a) => Identifier -> Snapshot -> Compiler (Item a) Source

Require a specific snapshot of an item.

loadBody :: (Binary a, Typeable a) => Identifier -> Compiler a Source

A shortcut for only requiring the body of an item.

    loadBody = fmap itemBody . load

loadSnapshotBody :: (Binary a, Typeable a) => Identifier -> Snapshot -> Compiler a Source

loadAll :: (Binary a, Typeable a) => Pattern -> Compiler [Item a] Source

This function allows you to `load` a dynamic list of items

loadAllSnapshots :: (Binary a, Typeable a) => Pattern -> Snapshot -> Compiler [Item a] Source

cached :: (Binary a, Typeable a) => String -> Compiler a -> Compiler a Source

unsafeCompiler :: IO a -> Compiler a Source

debugCompiler :: String -> Compiler () Source

Compiler for debugging purposes