XDOCS questions

[Tim Colson <tc...@cisco.com>]

This is not specific to Velocity, but I haven't found the answers on
Jakarta. They are I'm sure there somewhere, so please point me at the
link if that's easier.

Where is the DTD/Schema for the XDOC files?
Is it XHTML? 
(I ask, because I downloaded a few different 'xml' editors, and they
need to have the DTD/Schema so they can be helpful for editing
correctly.)

How would one include the markup and where would one place a gif/jpg
image to include a diagram into the final document?

Just curious to know if there has been discussion around Forrest and
Jakarta docs?
(the printable -> PDF version is IMHO quite nice, but alas it uses XSLT,
ugh)
http://xml.apache.org/forrest/index.html


Thanks,
Tim


--
To unsubscribe, e-mail:   <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>

RE: XDOCS questions - Summary

[James Taylor <ja...@jamestaylor.org>]

> Hmm... ok, I read through a bunch of that...but the goose chase didn't
> yield anything solid about the _relationship_ with Forrest. I can only
> guess that two Jakarta factions created two xml-based documentation
> systems based on different tech (XSLT/Velocity) and that they don't
> speak much to each other about their respective religions. <grin>
> 
> It's too bad too, because DVSL is slick compared to XSLT, but the PDF
> output of Forrest is slick compared to the printable-html view using
> DVSL. Plus, Forrest has a DTD :-)

What is kind of funny is that (in cvs) maven has dropped dvsl entirely
in favor of JSL. This was entirely a performance / memory usage driven
decision though, nothing against the slickness of DVSL.

Also, maven does have a PDF generation plugin. It is imperfect because
of the limiatations of FOP (specifically wrt tables) but it works.


--
To unsubscribe, e-mail:   <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>

RE: XDOCS questions - Summary

[Tim Colson <tc...@cisco.com>]

I had asked:
> Where is the DTD/Schema for the XDOC files?
Jon replied:
http://jakarta.apache.org/site/jakarta-site2.html
http://jakarta.apache.org/site/jakarta-site-tags.html

Summary of reading that is "there is no DTD/Schema". 

"There is currently no DTD for Anakia, however if there is a parse error
in the file, Anakia will report the error and line number of the error
according to what the parser reported."

> Is it XHTML?
Partially. Apparently Anakia (and I assume also DVSL) will puke if
there's anything it doesn't like.

> Just curious to know if there has been discussion 
> around Forrest and Jakarta docs? 
Jon gave this reply:
> http://jakarta.apache.org/turbine/maven/

Hmm... ok, I read through a bunch of that...but the goose chase didn't
yield anything solid about the _relationship_ with Forrest. I can only
guess that two Jakarta factions created two xml-based documentation
systems based on different tech (XSLT/Velocity) and that they don't
speak much to each other about their respective religions. <grin>

It's too bad too, because DVSL is slick compared to XSLT, but the PDF
output of Forrest is slick compared to the printable-html view using
DVSL. Plus, Forrest has a DTD :-)

BTW - Velocity/DVSL isn't mentioned in the Maven User Guide, but burried
deep in the Directory Layout, there is a reference. And also an answer
to my question of "Where do I put images?"

-> looks like xdocs/images... simple enough.

Heh heh, I also noticed a sidestep in the Maven FAQ's that the
VM_global_libary.vm error "doesn't really cause the build to fail."
Hah. Ignore this mesg...it's a lie.  ;-)

Cheers,
Tim


--
To unsubscribe, e-mail:   <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>

Re: XDOCS questions

[Jon Scott Stevens <jo...@latchkey.com>]

on 2002/12/27 7:45 AM, "Tim Colson" <tc...@cisco.com> wrote:

> This is not specific to Velocity, but I haven't found the answers on
> Jakarta. They are I'm sure there somewhere, so please point me at the
> link if that's easier.
> 
> Where is the DTD/Schema for the XDOC files?
> Is it XHTML? 
> (I ask, because I downloaded a few different 'xml' editors, and they
> need to have the DTD/Schema so they can be helpful for editing
> correctly.)

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

> How would one include the markup and where would one place a gif/jpg
> image to include a diagram into the final document?

<p>
<img src="" />
</p>

> Just curious to know if there has been discussion around Forrest and
> Jakarta docs?
> (the printable -> PDF version is IMHO quite nice, but alas it uses XSLT,
> ugh)
> http://xml.apache.org/forrest/index.html

http://jakarta.apache.org/turbine/maven/

-jon


--
To unsubscribe, e-mail:   <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>