a util for compiling HTML/PDF documents using Hiccup style templates
source link: https://github.com/yogthos/doc-builder
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.
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
- install Lumo
- check out this project locally
-
run
npm install
-
update
documents/sample.edn
with your data -
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"}
-
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 .
Recommend
About Joyk
Aggregate valuable and interesting links.
Joyk means Joy of geeK