1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
|
R E A D M E
===========
Welcome to the VelocityTools projects. This is a subproject of the
Apache Velocity project hosted at http://velocity.apache.org/
The VelocityTools project contains three subprojects:
VelocityStruts
Includes tools specific to integrating Velocity and Struts. This
package sits on top of (requires) the VelocityView package.
VelocityView
Package containing the VelocityViewServlet for rendering Velocity
templates. There is no controller functionality - it's akin to the
JspServlet. It includes toolbox support. (Also contains a
VelocityLayoutServlet to support more advanced template rendering
as an alternative to Tiles.)
Generic tools
A collection of general purpose tools that may be used independently of
the VelocityView or VelocityStruts package (but is included with both).
Build Instructions
------------------
Building the project requires JDK 1.5 or higher and ant 1.7
or higher. There is an ant script included that builds the entire
project, including all three subprojects, documentation, application
examples, etc. To build the project, start ant in the root directory
of the project:
> ant
To return the project to the original virgin state, execute:
> ant clean
By default, the project will build the VelocityStruts jar, javadoc and
project documentation.
To build only the VelocityStruts jar (which includes both VelocityView classes
and the generic tools), execute:
> ant jar.struts
To build only the VelocityView jar (which includes the generic tools), execute:
> ant jar.view
To build only the generic tools jar, execute:
> ant jar.generic
To build only the simple example for VelocityView, execute:
> ant simple
To build only the VelocityStruts example, execute:
> ant struts
To build only the Showcase example, execute:
> ant showcase
Please note:
- Due to new compile-time dependencies, VelocityTools can only be compiled on JDK 1.5
or higher
The build process has been tested with JDK 1.5. The
included example applications have been tested with Tomcat,
but should work with any web container.
If you observe any problems with the build process, please report this
to the Velocity users mailing list, user@velocity.apache.org, and
put [veltools] in the subject line.
Documentation
-------------
The project includes brief overview documentation and more detailed
documentation for each subproject. Follow the 'Build Instructions' to
build then project, then, point your browser at docs/index.html
Feedback
--------
We welcome your feedback to user@velocity.apache.org.
$Revision: 672844 $ $Date: 2008-06-30 10:53:20 -0700 (Mon, 30 Jun 2008) $
|
