Skip to content

antlr/stringtemplate4

Folders and files

NameName
Last commit message
Last commit date

Latest commit

bb92568 · Dec 3, 2022
Apr 2, 2022
Dec 22, 2019
Dec 3, 2022
Nov 10, 2018
Dec 3, 2022
Dec 3, 2022
Jan 12, 2020
Dec 13, 2021
Dec 24, 2019
Dec 13, 2021
Mar 25, 2014
Apr 2, 2022
Dec 3, 2022
Dec 13, 2021
Dec 3, 2015
Apr 2, 2022
Sep 2, 2022
Apr 2, 2022
Jan 30, 2013
Dec 3, 2022

Repository files navigation

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.

The main website is:

https://www.stringtemplate.org

Its distinguishing characteristic is that it strictly enforces model-view separation, unlike other engines. See:

https://www.cs.usfca.edu/~parrt/papers/mvc.templates.pdf

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.

INSTALLATION

Manual Installation

All you need to do is get the StringTemplate jar into your CLASSPATH. See Java StringTemplate.

Maven

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.4</version>
  <scope>compile</scope>
</dependency>

Gradle

In build.gradle, add the following dependency:

dependencies {
    // ...

    // https://mvnrepository.com/artifact/org.antlr/ST4
    compile group: 'org.antlr', name: 'ST4', version: '4.3.4'
}

Make sure you are using the mavenCentral repository by adding it if necessary:

repositories {
    // ...
    mavenCentral()
}

Other

Select a version on mvnrepository, and copy the snippet relevant to your build tool.

BUILDING FROM SOURCE

The source is at github.com:

https://github.com/antlr/stringtemplate4

If you would like to make changes to ST and build it yourself, just run mvn install from the root directory of the repo.

You can also run ant from the root dir.