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/stylesheets/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

Reply via email to