heist
An Haskell template system supporting both HTML5 and XML.
| Version on this page: | 1.1.1.2 |
| LTS Haskell 24.2: | 1.1.1.2@rev:5 |
| Stackage Nightly 2025-08-02: | 1.1.1.2@rev:5 |
| Latest on Hackage: | 1.1.1.2@rev:5 |
heist-1.1.1.2@sha256:5b349daca9db76147bf7c26b0e10c6a4a5b93f8137658ae29de25d86d3de45e8,8655Module documentation for 1.1.1.2
Heist
Heist, part of the Snap Framework, is a Haskell library for xml/html templating. It uses simple XML tags to bind values to your templates in a straightforward way. For example, if you were to put the following in a template:
<bind tag="message">some text</bind>
<p><message/></p>
the resulting xhtml would be
<p>some text</p>
Likewise, if you need to add text to an attribute,
<bind tag="special">special-id</bind>
<div id="${special}">very special</div>
gives you
<div id="special-id">very special</div>
Values can also be pulled from “Splices” (see the documentation for more information.)
Building heist
The heist library is built using Cabal and Hackage. Just run
cabal install
from the heist toplevel directory.
Building the Haddock Documentation
The haddock documentation can be built using the supplied haddock.sh shell
script:
./haddock.sh
The docs get put in dist/doc/html/.
Building the testsuite
To build the test suite, cd into the test/ directory and run
$ cabal configure
$ cabal build
From here you can invoke the testsuite by running:
$ ./runTestsAndCoverage.sh
The testsuite generates an hpc test coverage report in test/dist/hpc.