Re: [Springframework-developer] website

[William G. T. Jr. <wg...@rc...>]

I thought the whole point of maven was to reduce the amount of work 
needed to create a project web site and documentation.

If maven is too "heavy weight", perhaps the Forrest project would be 
more to your liking.  The docs are in a "docbook-lite" XML
format and out of the box it generates HTML and PDF.  Having the site 
and docs in XML will make it easier to keep the site
consistent and make it easier for folks to contribute good docs.

I am currently working on a doc for the uPortal project using Forrest. 
Here are example links:

source document: 
http://rci.rutgers.edu/~wgthom/forrest/site/eclipse-uportal-howto.xml
generated html: 
http://rci.rutgers.edu/~wgthom/forrest/site/eclipse-uportal-howto.html
generated pdf: 
http://rci.rutgers.edu/~wgthom/forrest/site/eclipse-uportal-howto.pdf

later.
Bill



Isabelle Muszynski wrote:
> Hi guys,
> 
> Forgot one point : maven.
> I think we already have a lot to worry about (i.e. work for) without adding one more ingredient to the stew. Maven looks really good, and we should use it at some point, but can we please try to get a release out without having to learn yet one more thing? 
> If we talk about a standard format for docs, then I like docbook and FOP. But it means having to write xml, which isn't as easy as writing text.
> Right now I'm planning to produce PDF's for the docs, it's portable and everybody has a viewer. I'll also be able to produce HTML from the docs, so that we can put an online version on the website.
> 
> Isabelle
>