Re: [OS-webwork] xbook

[Bill Burton]

Hello,

Aslak Hellesøy wrote:

Maven currently uses DVSL (which is kind of Velocity++). You'll find the
code in Maven's xdoc plugin.

-But they're actually moving from DVSL to JSL. http://tinyurl.com/3gzw

I assume you mean Jelly Stylesheet Library http://jakarta.apache.org/commons/sandbox/jelly/tutorial.html#jsl?

-Bill

Aslak

-----Original Message-----
From: [EMAIL PROTECTED]
[mailto:[EMAIL PROTECTED]]On Behalf Of
Bill Burton
Sent: 12. desember 2002 18:09
To: [EMAIL PROTECTED]
Subject: Re: [OS-webwork] xbook


Hello,

Aslak Hellesøy wrote:

xbook looks like something else.

Yes.

xdoc is a proprietary xml format invented by jakarta. it's kind of plain
xhtml with some extra tags (section, source...) to mark

sections ans source

sections.

details are here:

http://jakarta.apache.org/site/jakarta-site-tags.html

This is a good overview of what the xdoc XML looks like.

You can check out the Jakarta CVS site2 module, which includes Anakia
and what you need to build any xdoc.  See
http://jakarta.apache.org/site/jakarta-site2.html.

i think there are only two tools that can transform xdoc

documents to human

readable documents:

o anakia (part of velocity). it transforms to docs with a look

similar to

the link above.
o maven. it transforms to docs like on the maven site itself.

it can also

transform them to pdf.

DVSL (http://jakarta.apache.org/velocity/dvsl/index.html).  Grab the
latest version and then run the Ant build.xml to DVSL's docs which are
in xdoc format.  The included stylesheet renders output similar to the
Anakia stylesheets used for the Jakarta sites.  See
http://cvs.apache.org/viewcvs/jakarta-velocity-dvsl/src/stylesheet

s/site.dvsl?rev=1.4&content-type=text/vnd.viewcvs-markup.
  Since you seem to understand XSLT, DVSL will make more sense to you.
Although it hasn't been released yet, it's been stable for a number of
months.

There is also an XSLT stylesheet included with the Jakarta CVS site2
module (above) that renders similar output to the Jakarta sites which
will be helpful to get you started in transforming xdoc XML.  Here it is
in CVS
http://cvs.apache.org/viewcvs/jakarta-site2/xdocs/stylesheets/site.xsl?rev=1
.5&content-type=text/vnd.viewcvs-markup.

it's of course possible to roll your own xslt to transform xdoc documents.
it's also possible to use anakia (or maven) and tweak the stylesheets they
provide. neither of anakia/maven use xslt stylesheets, but velocity to do
the actual transformation.

I looked through the Maven CVS and then of some projects using Maven but
wasn't able to find exactly what it's using to perform the xdoc
transformation.  I did find some DVSL related info but I couldn't tell
if it was using that or something else.

Maven seems to be a rather comprehensive toolset for documenting and
building projects.

-Bill

aslak

-----Original Message-----
From: [EMAIL PROTECTED]
[mailto:[EMAIL PROTECTED]]On Behalf Of Ken
Egervari [eXtremePHP]
Sent: 12. desember 2002 14:05
To: [EMAIL PROTECTED]
Subject: [OS-webwork] xbook


I've searched around google and this is the xdoc implementation that I
found:

http://www.justobjects.org/xbook/

This is the one, correct?

-------------------------------------------------------
This sf.net email is sponsored by:
With Great Power, Comes Great Responsibility
Learn to use your power at OSDN's High Performance Computing Channel
http://hpc.devchannel.org/
_______________________________________________
Opensymphony-webwork mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/opensymphony-webwork