> > Has anyone looked at the Maven PDF plugin, which is distributed with
> > Maven:
> > http://maven.apache.org/reference/plugins/pdf/
> 
> This is what it did against the site as it stands now...
> 
>    http://svn.apache.org/builds/struts/maven/trunk/site-test/pdf/struts.pdf

As a member of a confirmed ant shop, I had never seen this plugin.  It
probably comes as no surprise to Maven backers that the plugin in fact
does much of what I had done, as well as a few things still on my
to-do list.  That said, here are a couple issues with the Maven
output:

- Internal links in the PDF do not work.  This is the big one, and
*may* just be because the struts docs in the user guide do not always
comply with the jakarta site2 doc format; internal links work on my
hand-rolled version in part because I was specifically taking the
struts idiosyncracies into account.  Wendy is going through the
laborious process of bringing the XML files into compliance, so this
issue may be automagically resolved once that work is completed.

- "Chapter" formatting.  The pages break oddly in points, but these
will probably also be resolved once the input docs are updated.

- Bookmarks.  Especially on long PDF files, I like having the
bookmarks on the side.  The current version of the Maven PDF plugin
does not appear to generate these.

There are probably others, but the Maven plugin looks very promising,
and it would be silly to go our own way if Maven can give it to us for
free.  Once Wendy has completed the doc conversion, I will try this
plugin again, and see what else crops up.

As for bookmarks, I have some Maven homework to do, but it makes more
sense to try and integrate my PDF-bookmark-generating XSLT into the
pdf plugin, and (assuming I make it work generically) look into
offering it back to that project.

-Greg

---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to