On 8/12/05, Wendy Smoak <[EMAIL PROTECTED]> wrote: > Martin's request for PDF documentation caught the eye of XSL-FO expert Greg > Ludington, who emailed me this morning with a first draft of the Struts User > Guide in PDF. With his permission, I've placed it on the draft website, and > you can see it here: > > > http://svn.apache.org/builds/struts/maven/trunk/site-test/pdf/userGuidev0_1.pdf
Whoa! This is cool! There are definitely some oddities that need cleaning up, but this is an awesome start. I have some stylistic opinions, too, but I'll hold off on those for the moment. > Any oddities in section numbering and formatting are not his fault. :) Our > XML docs are very inconsistent-- Greg has provided a long (and probably > still incomplete) list of problems he found while writing the XSL. As part > of the website conversion, I'll attempt to address those so he won't have to > work quite so hard on the transformation. Great! > Since we will be using the Jakarta Site xml doc format > (http://jakarta.apache.org/site/jakarta-site2.html), Greg's work should be > useful to many projects, not just Struts. If anyone is on jakarta-general, > it might be worth checking just to make sure we're not duplicating effort, > but a quick search of their mailing list didn't turn up anything recent > about PDF generation. There's nothing happening on [EMAIL PROTECTED], but there's a recently created site-dev list. There hasn't been a lot of action there yet, though. I'm thinking that, if this is general enough to work for any project that uses the site2 format, it might also be a great candidate for a Maven plugin. But perhaps we can talk about that a bit later. ;-) > We've been talking about how best to leverage work that's already done-- > possibly transforming the Jakarta xml docs into docbook, and from there > generating the both the HTML and PDF. (This applies to the documentation, > not the multiproject website.) Other suggestions are welcome. > > Thanks, Greg! We're looking forward to your contributions. :) Yes, indeed! -- Martin Cooper > -- > Wendy Smoak > > > > --------------------------------------------------------------------- > To unsubscribe, e-mail: [EMAIL PROTECTED] > For additional commands, e-mail: [EMAIL PROTECTED] > > --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
