I think I'll look into this xdoc approach as I have not used it myself although I'm sure it's very similar. If it can do direct xml -> pdf generation with 'zero' code (in addition to formats like html), then I'm all for that =)
I'll get back to you on this as I check it out for myself. Regards, Ken ----- Original Message ----- From: "Aslak Hellesoy" <[EMAIL PROTECTED]> To: <[EMAIL PROTECTED]> Sent: Tuesday, December 10, 2002 3:31 PM Subject: RE: [OS-webwork] Documentation > > > > -----Original Message----- > > From: [EMAIL PROTECTED] > > [mailto:[EMAIL PROTECTED]]On Behalf Of > > Bill Burton > > Sent: 10. desember 2002 21:05 > > To: [EMAIL PROTECTED] > > Subject: Re: [OS-webwork] Documentation > > > > > > Hello, > > > > Aslak Hellesoy wrote: > > > Why don't you write documentation in xdoc format? This is > > basically XHTML, > > > augmented with 3-4 special tags. Then you can use Maven to > > generate HTML, > > > PDF, RTF, whatever. > > > > Yes, I was thinking the same thing. It's practically like writing HTML > > but with simple tags for indicating headings, etc. By xdoc, I assume > > you're referring to what's used for the http://jakarta.apache.org and > > http://httpd.apache.org docs. Those docs are generated by Anakia, a > > Velocity based tool run from Ant. The next generation of this tool is > > DVSL which is much more like XSLT (supporting XPath, etc.) but easier to > > use. > > > > That's exactly what I meant, but I'd use Maven instead of Anakia. Maven > understands the same xdoc syntax as Anakia, and is able to produce > nicer-looking HTML docs than Anakia. -With a neat navigation pane to the > left. > > Sample page: http://boss.bekk.no/boss/middlegen/ant/table.html > Source: http://tinyurl.com/3epq > > Maven vs Anakia: http://jakarta.apache.org/turbine/maven/start/anakia.html > > The navigation is maintained in a separate file called navigation.xml, and > Maven weaves everything together into a nice web page. -And you can tell > Maven to generate PDF from the same xdoc files. It's already built into > maven. Just type "maven pdf". > > I can really recommend Maven. -Not only for the doc generation, but for the > awesome build system it provides. > > > You can read about DVSL at > > http://jakarta.apache.org/velocity/dvsl/index.html. > > > > The main thing is that the doc source should be in some simple XML > > format that's easy to edit without special tools. The HTML and PDF can > > then be generated with whatever tools are suitable. > > > > The best argument I can think of to illustrate why keeping the doc > > source in XML is important is the same one for using WebWork over > > writing Java in JSP's--keeping the logic and data separate from the > > presentation. > > > > Killing point :-) > > Cheers, > Aslak > > > -Bill > > > > > > > > Aslak > > > > > > > > >>-----Original Message----- > > >>From: [EMAIL PROTECTED] > > >>[mailto:[EMAIL PROTECTED]]On Behalf Of > > >>Simon Stewart > > >>Sent: 10. desember 2002 19:00 > > >>To: [EMAIL PROTECTED] > > >>Subject: Re: [OS-webwork] Documentation > > >> > > >> > > >>On Tuesday, Dec 10, 2002, at 16:32 Europe/London, Ken Egervari > > >>[eXtremePHP] wrote: > > >> > > >>>XSLT will also help us out if the website presentation layer changes > > >>>or when > > >>>we decide to compile the manual into a PDF document (which I really > > >>>hope we > > >>>do since PDF is a fantastic format for printing and offline viewing). > > >>>XML > > >>>will critical to achieve this. > > >> > > >>Maybe I'm just a little bit confused, but won't both the XML and the > > >>HTML crowd be happy with XHTML? Seems like a Really Obvious Solution. > > >>Fine, you can't use the Docbook tools that come with lots of linux > > >>distros, but that's just a minor implementation detail --- I bet that > > >>there are loads of people champing at the bit for a tool to convert > > >>their websites to PDF :) > > >> > > >>Regards, > > >> > > >>Simon > > > > > > > > ------------------------------------------------------- > > 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 > > > > ------------------------------------------------------- > 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 > ------------------------------------------------------- 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