blob: 7a62c1eaaa2dbd56291497a01bfa955930bf1194 [file] [log] [blame]
<?xml version="1.0" encoding="UTF-8"?>
<document>
<properties>
<title>Velocity</title>
<author email="jvanzyl@zenplex.com">Velocity Documentation Team</author>
</properties>
<body>
<section name="What is Velocity?" href="WhatisVelocity?">
<p> Velocity is a Java-based template engine. It permits anyone to use a simple yet
powerful template language to reference objects defined in Java code. </p>
<p> When Velocity is used for web development, Web designers can work in parallel with
Java programmers to develop web sites according to the Model-View-Controller (MVC)
model, meaning that web page designers can focus solely on creating a site that looks
good, and programmers can focus solely on writing top-notch code. Velocity
separates Java code from the web pages, making the web site more maintainable over its
lifespan and providing a viable alternative to
<a href="http://java.sun.com/products/jsp/">Java Server Pages</a> (JSPs) or
<a href="http://www.php.net/">PHP</a>. </p>
<p> Velocity's capabilities reach well beyond the realm of the web; for example, it can
be used to generate SQL, PostScript and XML (see
<a href="docs/anakia.html">Anakia</a> for more information on XML
transformations) from templates. It can be used either as a standalone utility for
generating source code and reports, or as an integrated component of other systems.
For instance, Velocity provides template services for the
<a href="http://jakarta.apache.org/turbine/">Turbine</a> web application
framework, together resulting in a view engine facilitating development of web
applications according to a true MVC model. </p>
</section>
<section name="Where do I get releases?" href="WheredoIgetreleases?">
<p> The current release version is version 1.4. </p>
<p> The release distribution is available as a combined source/binary distribution in
<code>tar.gz</code> and
<code>zip</code> formats, and can be downloaded through the
<a
href="http://jakarta.apache.org/site/downloads/downloads_velocity.cgi">
Apache Mirror system</a>. </p>
<p> The Velocity jars are also available through the
<a href="http://www.ibiblio.org/maven/velocity/">central Maven
repository</a>. </p>
<p> Older releases are archived at the
<a href="http://archive.apache.org/dist/jakarta/velocity/"> Jakarta
Velocity archives</a>. </p>
</section>
<section name="Where do I get nightly snapshots?"
href="WheredoIgetnightlysnapshots?">
<p> Nightly snapshots of the Velocity subversion source code tree can be found
<a href="http://svn.apache.org/snapshots/jakarta-velocity/"> here</a>. </p>
<p> These are meant to provide easy access to the actual project source control tree. As
this is our live development workspace, there are no guarantees as to what you will
find there, although we do our best to maintain a buildable source tree. If you are
looking for the stable supported release, please use the current release of
Velocity. </p>
<p> If you are willing to risk getting dirty, we invite you to try the nightly snapshot to
see the current state of affairs. (and help out!)
<a href="http://www.apache.org/dev/version-control.html">Public Subversion
access</a> is also available. </p>
</section>
<section name="How do I contribute, give feedback, fix bugs and so on?"
href="HowdoIcontribute,givefeedback,fixbugsandsoon?">
<p> The Velocity project appreciates any contributions, including documentation
help, source code and feedback. Suggested changes should come in the form of source
code and/or feedback. </p>
<ul>
<li> Report bugs, ask questions, and help new users on the
<a href="http://jakarta.apache.org/site/mail2.html#Velocity"> Velocity
mailing lists</a>. </li>
<li> There's a list of issues waiting to be addressed in
<a href="http://issues.apache.org/jira/browse/VELOCITY"> JIRA</a>. </li>
<li>
<a href="http://wiki.apache.org/jakarta-velocity/FrontPage"> Our Wiki</a>
has a large collection of community written content. Add your own article or
contribute to the FAQ! </li>
<li> Read-only access to the Subversion
<strong>jakarta-velocity</strong> repository is available both
<a href="http://svn.apache.org/repos/asf/jakarta/velocity/engine/trunk/">
online</a> and with a
<a href="http://www.apache.org/dev/version-control.html"> Subversion
client</a>. </li>
</ul>
</section>
</body>
</document>