''updated for version 2.1.0''

[{TableOfContents}]


!!Using ztemplates with maven

ztemplates build is now done with [maven|http://maven.apache.org/] __version 2.2.1 or later__. Version before 2.2.1 (like 2.0.9) have problems doing the tests, so use with -DskipTests if you cannot change to later version. It is advisable though not required to use maven2 for your ztemplates projects. See the demos for a starting point.

!ztemplates versions after 2.0.0 are available from central maven repository

{{{

<dependency>
    <groupId>org.ztemplates</groupId>
    <artifactId>ztemplates</artifactId>
    <version>2.0.0</version>
</dependency>

}}}

Snapshots of not released versions can be found in [https://oss.sonatype.org/content/repositories/snapshots/org/ztemplates/ztemplates/]

!gotcha

Because the ztemplates resources (velocity/freemarker templates, css files) are typically placed in the same directory as the java files you have to tell maven2 to include resources from the src/main/java directory, and exclude the java files. 

Add the following lines to your pom.xml:

{{{
<build>
...
  <resources>
    <resource>
      <directory>src/main/java</directory>
      <excludes>
        <exclude>**/*.java</exclude>
      </excludes>
    </resource>
  </resources>
...
</build>
}}}

This will include all necessary files from "src/main/java" into your build artifacts.


!Running a ztemplates application with the maven tomcat plugin

The current version can be run with 
{{{

mvn tomcat:run-war

}}}


The following will not work, as the classes and resources are not available in the webapp classpath.

{{{

mvn tomcat:run 

}}}