ST (StringTemplate) is a java template engine (with ports for C#, Python, and Objective-C coming) for generating source code, web pages, emails, or any other formatted text output. ST is particularly good at multi-targeted code generators, multiple site skins, and internationalization / localization. It evolved over years of effort developing jGuru.com and then ANTLR v3.
Given day-job constraints, my time working on this project is limited so I'll have to focus first on fixing bugs rather than changing/improving the feature set. Likely I'll do it in bursts every few months. Please do not be offended if your bug or pull request does not yield a response! --parrt
The main website is:
Its distinguishing characteristic is that it strictly enforces model-view separation, unlike other engines. See:
The documentation is in this repo
https://github.com/antlr/stringtemplate4/tree/master/doc/index.md
Per the BSD license in LICENSE.txt, this software is not guaranteed to work and might even destroy all life on this planet.
All you need to do is get the StringTemplate jar into your CLASSPATH. See Java StringTemplate.
To reference StringTemplate from a project built using Maven, add the following
to the <dependencies> element in your pom.xml file.
<dependency>
<groupId>org.antlr</groupId>
<artifactId>ST4</artifactId>
<version>4.3</version>
<scope>compile</scope>
</dependency>In build.gradle, add the following dependency:
dependecies {
// ...
// https://mvnrepository.com/artifact/org.antlr/ST4
compile group: 'org.antlr', name: 'ST4', version: '4.3'
}Make sure you are using the mavenCentral repository by adding it if necessary:
repositories {
// ...
mavenCentral()
}Select a version on mvnrepository, and copy the snippet relevant to your build tool.
The source is at github.com:
If you would like to make changes to ST and build it yourself,
just run mvn compile from the root directory of the repo.
You can also run ant from the root dir.