On Thu, Sep 06, 2001 at 03:21:51PM -0400, Jason van Zyl wrote:
> On 9/6/01 12:05 PM, "Jim Moore" <[EMAIL PROTECTED]> wrote:
>
> > Is there an ant target for building the docs?
>
> If you are going to use DocBook which is what Avalon uses for it's docs than
> you can use Cocoon2 to transform your documents and you could probably make
> a simple Ant task if there isn't already one.
That would be very nice. In particular, a task which, like javac, examined the
timestamps of source (*.xml) and generated (*.html) files, and only rendered
the ones which were modified.
The downside to making tools like this an Ant task is that they must be in the
Ant classpath, not simply in a classpath constructed within Ant. Eg, if you use
<stylebook>, then you need stylebook.jar in $ANT_HOME/lib, whereas if you use a
<java classname="org.apache.stylebook.."/>, you can have stylebook.jar
elsewhere. I think it's for this reason you'll find projects like Tomcat4 using
<java classname="junit.textui.TestRunner" /> instead of <junit>.
> I just know that Avalon uses Cocoon2 to transform their DocBook formatted
> documents. They also have it integrated into their build system so you could
> probably just lift what they have.
With the disclaimer that it's not perfect ;) It's 2.4mb extra jars. It's
relatively slow compared to straight XSLT. It doesn't exit on encountering
invalid XML, but renders an error message. But it's pretty cool nonetheless.
--Jeff
>
[snip]
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
