https://github.com/antlr/stringtemplate4

StringTemplate 4
https://github.com/antlr/stringtemplate4

Last synced: about 2 months ago
JSON representation

StringTemplate 4

• Host: GitHub
• URL: https://github.com/antlr/stringtemplate4
• Owner: antlr
• License: other
• Created: 2010-02-04T01:37:35.000Z (over 14 years ago)
• Default Branch: master
• Last Pushed: 2023-11-19T20:33:01.000Z (7 months ago)
• Last Synced: 2024-04-02T21:31:48.969Z (3 months ago)
• Language: Java
• Homepage: http://www.stringtemplate.org
• Size: 2.91 MB
• Stars: 919
• Watchers: 56
• Forks: 228
• Open Issues: 43
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGES.txt
  • License: LICENSE.txt

Lists

• awesome-java - StringTemplate - Template engine for generating source code, web pages, emails, or any other formatted text output. (Projects / Template Engine)
• awesome - antlr/stringtemplate4 - StringTemplate 4 (Java)
• awesome-java-zh - StringTemplate - 用于生成源代码，网页，电子邮件或任何其他格式化文本输出的模板引擎。 (项目 / 模板引擎)

README

        
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](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](doc/java.md).

### Maven

To reference StringTemplate from a project built using Maven, add the following

to the `` element in your **pom.xml** file.

```xml

  org.antlr

  ST4

  4.3.4

  compile

```

### Gradle

In `build.gradle`, add the following dependency:

```groovy

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:

```groovy

repositories {

    // ...

    mavenCentral()

}

```

### Other

Select a version on [mvnrepository](https://mvnrepository.com/artifact/org.antlr/ST4),

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.