a util for compiling HTML/PDF documents using Hiccup style templates

doc-builder

A simple data driven document builder for ClojureScript. A document is described using two files. One file conains HTML markup for the document in Hiccup format, and the other contains document data in EDN format. The library will inject the EDN data into the markup and compile it to either HTML or PDF formats.

Overview

The document data should be placed in an EDN file in the documents directory. See documents/sample.edn for an example.

The content of the data file is referenced by the template using a namespaced keyword in the following format:

:data/path.to.field

The keyword represents a get-in path to provide support for accessing nested fields in the document. The above will be translated into [:path :to :field] when the template is compiled.

When the template is loaded, the values from the data file will be injected into it. Templates can contain code referencing functions from Clojure core, e,g:

[:div.row
 (for [{:keys [network username url]} :data/basics.profiles]
   [:div.col-sm-6
    [:strong.network network]
    [:div.username
    [:div.url
    [:a {:href url} username]]]])]

Corresponding data payload should look as follows:

{:basics
 {:network  "Twitter"
  :username "john"
  :url      "http://twitter.com/john"}}

Templates use the following directory structure:

templates
  <template name>
    template.edn
    <related files>

Templates can reference CSS in files from the template directory, e.g:

[:page/css
   "css/bootstrap.min.css"
   "css/octicons.min.css"
   "css/resume.css"]

See the default template for a complete example.

Usage

0. install Lumo
1. check out this project locally
2. run npm install
3. update documents/sample.edn with your data
4. update the configuration file called config.edn as necessary:

{:template :default
 :formats  [:pdf :html]
 :pdf-opts {:format "A4"} ;defaults to Letter
 :document "sample.edn"
 :target   "build"}

5. build the resume ./build.cljs

License

Copyright © 2020 Dmitri Sotnikov

This program and the accompanying materials are made available under the terms of the Eclipse Public License 2.0 which is available at http://www.eclipse.org/legal/epl-2.0 .

This Source Code may also be made available under the following Secondary Licenses when the conditions for such availability set forth in the Eclipse Public License, v. 2.0 are satisfied: GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version, with the GNU Classpath Exception which is available at https://www.gnu.org/software/classpath/license.html .