Velocity - Velocity Getting Started

# Getting Started

Velocity is easy to use! A quick way to get started is to skim the references below, then look at the examples and source provided in the distribution. For developers writing web-based applications, the Web Application Guide is highly recommended!

- User's Guide - explains how to write Velocity templates
- Developer's Guide - explains how to use Velocity inside Java programs
- VTL Reference - concise syntax for Velocity Template Language (VTL)
- Web Application Guide - web-based application techniques and VelocityViewServlet tutorial

The best place to start is with the examples provided in the distribution, and with the source code itself, which is included.

# Downloading Velocity

You can download the latest release version of Velocity or Velocity Tools from the main Apache Velocity download site. For Velocity itself, source is included with the binary download.

If you want to download the latest source, you can do so via the Subversion (svn) source control system, or download a complete nightly snapshot.

Instructions for building Velocity from source can be found in the Build document.

# API Documentation

Our API documentation is available online, as part of the distribution package, and of course, you can generate it yourself from the included source code.

If you would like to create a full set of detailed API documentation for Velocity, go to the `build` directory and run:

ant javadocs

The docs will be found in the `/bin/apidocs/` directory.

Note: Velocity uses the Apache Ant build tool for all code and documentation generation, so you will need to have it installed. Velocity requires at least Apache Ant 1.7.