Yup. Spring uses Docbook. That's what I am going to try: single html
page (everything), multiple html pages, and PDF. Spring distro has this:
====
We're using the DocBook XSL distribution for HTML and PDF
generation. The best results can be achieved with the
Saxon XSLT processor (don't use Xalan!) and the Apache
FOP library.
The documentation is generated by Spring's build.xml file
for Ant. Targets included are:
* doc.pdf - generates the PDF documentation
* doc.html - generates the HTML documentation
* doc.htmlsingle - generates single page HTML documentation
* doc.clean - clean any output directories for docs
To generate documentation, you need to include a lot
of libraries, which haven't been added to CVS because
they're simply too big. The libraries can be found at:
http://static.springframework.org/spring/files/docbook-reference-libs.zip.
Download them, create a lib directory in the
docs/reference directory and unzip the zip there.
Then, the targets should work.
===
Paul
Wendy Smoak wrote:
On 2/13/07, Paul Benedict <[EMAIL PROTECTED]> wrote:
I agree with Ted's comments on the S1 layout. I am going to try some
experimenting with the Struts 1 User Guide for the 1.4 release and what
else we can do with it. I'll just do it for fun and see if I can make
HTML and PDF documents from one source. Stay tuned.
Did you find out what Spring uses?
Docbook will certainly do it. There are two Maven plugins that I know of.
There was a very nice pdf plugin for Maven 1, but so far nothing even
close for m2. There's some work done in "Doxia Book" which uses
iText, but I wasn't impressed with the output.
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
