Hey Andrea, all, Andrea, as you are right to say automating the build may be difficult. However, I don't really see the point. It's easy enough to have a PDF in subversion and have the authors regenerate that from Docbook periodically. Same for html. If you are editing docbook, you have a production chain since you want to see your output. Easy enough to commit your changes, create a PDF, commit the PDF. I'm not going to worry about maven doing docbook. Either someone will create a Maven2 plugin that 'just works' or I can do it by hand. I've got enough on my plate worrying about the words to not worry about the automated magic.
We have four choices for content production: confluence docbook *office (.doc or .odf) LaTeX which will produce increasingly more beautiful output in roughly that order. None of these currently can produce a PDF as part of the build system. Only confluence is automatically on the web. I don't know how to resolve the situation, only that I'm not going to try. I'm still struggling with content and the day I start writing, I'll fall into whatever I happen to pick unless the PMC makes a strong case for one or the other. Docbook I know can be made to produce html and pdf, although on GNOME, we generate the html on the fly within Yelp. --adrian On Thu, 2006-08-17 at 10:35 +0200, Andrea Aime wrote: > Jody Garnett ha scritto: > > We have recently been using docbook to go to eclipse help files (this > > has been great). We did try pdf and so > > on but will have to ask Gerhard here for how effective it was in practice. > > I asked. He used xsltproc instead of java based stuff for html because > he could not make it work with java, and pdf output was broken anyway... > > Seems someone among us need to do some serious testing of what maven offers > us, and/or decide that pdf documentation may be only generated on a linux > box... > > Cheers > Andrea ------------------------------------------------------------------------- Using Tomcat but need to do more? Need to support web services, security? Get stuff done quickly with pre-integrated technology to make your job easier Download IBM WebSphere Application Server v.1.0.1 based on Apache Geronimo http://sel.as-us.falkag.net/sel?cmd=lnk&kid=120709&bid=263057&dat=121642 _______________________________________________ Geotools-devel mailing list Geotools-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/geotools-devel
