Legacy documents are the bane of any software migration. The Velocity Team has tried to ensure that existing templates can be converted for use within Velocity in as painless a manner as possible.

Currently there is only a WebMacro to Velocity template converter, but there are plans for a Tea to Velocity template converter, and a FreeMarker to Velocity template converter.

The convert-wm.sh script in the convert directory converts a single WebMacro template (*.wm) to a Velocity template (*.vm), or converts an entire directory structure of WebMacro templates to Velocity templates.

The convert-wm.sh script can convert a single WebMacro template to a Velocity template.

This will produce a single Velocity template named template.vm from the WebMacro template template.wm. The original WebMacro template will be preserved.

To convert an entire directory structure of WebMacro templates using the convert-wm.sh script, simply include the directory name instead of the template name, as indicated below.

This will produce a directory structure of templates named templates/[template].vm. The original WebMacro templates will be preserved during the conversion process.