git clone ''

(ql:quickload :brennonyork.clj-template)


Ever begin to write HTML and feel the urge to gouge out your eyes? Ever realize you have to write XML and get the sudden urge to rip your hair out?

Welcome clj-template, a modern attempt to make writing HTML, XML, and other bracket-attribute structures simple, lightweight, and accessible to the Clojure community.

The founding principle behind clj-template is that of binding HTML tags to Clojure functions and allowing attributes to be passed in as Clojure maps. Why would someone do this? Well, aside from being overly verbose when typing typical HTML, moving into a pure Clojure-based solution allows a new type of templating engine where the user can leverage all the power of Clojure to generate his web pages.

Gone are the days of learning a given templating engine's DSL or wondering whether a given engine supports a certain data structure, looping capability, output function, etc. Purity in the Clojure language grants all the expressiveness of Clojure without any of the heartache of polyglot projects (i.e. mixing .html, .hbs, and .clj files).

Key Features


To jump in and get started simply add:

Referring Clojure

To refer Clojure into a project you can use the following example namespace as a guide.

  (:refer-clojure :rename {map clj-map meta clj-meta time clj-time})
  (:require [clj-template.html5 :refer :all]))

This refers all clojure.core into the namespace (substitute for your project) and renames:

…which removes all collision issues when working with html-based clj-template capabilities.


clj-template makes it very simple to generate html. Assuming you've loaded clj-template.html into your namespace we can start with some very basic examples.

Generating a simple webpage

  (head (title {:style "font-family:'Courier';"} "My Simple Web Site"))
  (body (p "A paragraph of content.") (br)
        (p "Another paragraph of content")))

which will output…

  <head><title style="font-family:'Courier';">My Simple Web Site</title>
  <body><p>A paragraph of content.</p><br></br>
        <p>Another paragraph of content</p>

Now, when rendering this you might notice that the pesky <br></br> element turns into two separate <br> tags. To resolve this, and achieve the intended results, we suffix the function with a dash (i.e. br-) which will render an unbalanced node (i.e. <br />).

Our modified code then looks like…

  (head (title {:style "font-family:'Courier';"} "My Simple Web Site"))
  (body (p "A paragraph of content.") (br-)
        (p "Another paragraph of content")))

which renders…

  <head><title style="font-family:'Courier';">My Simple Web Site</title>
  <body><p>A paragraph of content.</p><br />
        <p>Another paragraph of content</p>

User-defined bracket-attribute tags

clj-template is all based off of two core functions (in core.clj no less); those being assoc-to-fn and assoc-to-fn-unbalanced. Both functions take a vector of strings and then drop those strings as first-class functions into the currently called namespace. That said, if one wanted to generate their own tags for a bracket-attribute document it would merely call those above functions. As an example we'll use balanced tags for:

…and unbalanced tags for:

The code would then look as follows:

  (:refer-clojure :rename {name clj-name})
  (:require clj-template.core))
(clj-template.core/assoc-to-fn ["addr" "doc" "text"])
(clj-template.core/assoc-to-fn-unbalanced ["name"])

  (name- {:first "Bill" :last "Edwards"})
  (text "Some additional text"))
 (addr {:ref "uri://localhost"}
  (name- {:first "Jim" :last "Jones"})))

…which would output:

    <name first="Bill" last="Edwards" />
    <text>Some additional text</text>
  <addr ref="uri://localhost">
    <name first="Jim" last="Jones" />


Copyright © 2014

Distributed under the Eclipse Public License.