This is a small release that contains test cases and fixes for minor bugs. From this version, we are using Cloverage for checking the status unit test coverage.

Bug fixes

• Fix arithmetic of modulo and power operators.

Improvements

• Cache of fragment objects can be cleaned up.

What is new

This release introduces the concept of document fragments. Fragments are a special type of templates that let the user embed parts of documents in the template. For example, headers and footers can be stored in distinct template documents so it is possible to reuse parts across documents.

Improvements

• Added support for elseif syntax.
• Added example documents.
• New function: xml() lets you embed XML parts to the document.
• Performance improvements by removing unnecessary parallelism.

The aim of this release is to build an useful command-line tool using Stencil for batch template processing. This included work on better error messages and many improvements on the standalone mode.

The stencil-core-0.2.10-linux is a linux executable built with GraalVM for faster startup time and minimal dependency requirements.

Improvements

• Standalone mode has a help screen and some useful error messages were introduced.
• Added friendly error messages for many different template parsing errors.
• Added a build script to build standalone stencil to a native image for command-line usage.

Improvements

• Added resize-first resizing strategy.
• Added elseif/elsif/elif shorthands for writing else if.
• Support for strong tags in the html() function.
• Added standalone mode for batch processing.

Bug fixes

• Table left/top borders are kept after hiding left column or top border.
• Bug on windows broke template rendering, see #20

Improvements

Tables

• tables now preserve both left and right borders when hiding a column.
• restore table bottom border when last row is hidden

Stencil service

• error handling on env variables in dockerized stencil service.

• added join() string function

Bugfixes

• Downgraded required minimum Clojure version to 1.8.0
• Fixed .cleanup() method in PreparedTemplate instances. It should successfully delete temporary directory.
• Fixed CircleCI build script by hard coding dependency versions.

Future

Actively working on a standalone CLI application to render documents in batch.

Improvements

• it is possible to embed dynamic HTML content for simple formatting #10 #13 with the new html() function

Bugfixes

• fix bug with clojure api with :overwrite? key.

This release contains many small improvements. Main highlights are support for pptx files and compatibility fixes for Word.

Improvements

• More readable error messages on syntax errors
• Introduce STENCIL_JAVA_OPTIONS env var in docker service for tuning the JVM
• Clojure API render! function now works with template data map of keyword keys.
• Added mathematical functions for rounding a number to integer: round, ceil, floor (#3)
• Added support for pptx (PowerPoint presetation) files (#9)

Bugfixes

• #4 disappearing whitespaces in Word.
• #7 #8 errors on double logical negation.
• Fix evaluation order of arguments in logical operators.
• make PreparedTemplate instances clean up temporary cache directories when discarded (#12)

Future

For the next release the main priorities are the followings.

• Better and more readable error messages on syntax errors in template files.
• Capability to dynamically include images
• Capability to dynamically include html content

Created a simple application and Dockerfile for running stencil in a container as a microservice. Read the service documentation for details.