Re: Our site is too big

Berin Loritsch wrote:
> From: Nicola Ken Barozzi [mailto:[email protected]]
> 
> Paul Hammant wrote:
> 
>>Folks,
>>
>>Have we chosen a xdocs->html technology for the avalon-site depot?
>>
>>  Forrest, Anakia, Cocoon?
> 
> Given that Forrest is to prefer to plain Cocoon since it's
> Cocoon based
> but tailored for our use, and that the only one holding back IIRC on
> Anakia has since then decided to use Forrest (see Phoenix docs), I'd
> choose Forrest.
> 
> As long as it works, I am +1.
> 
> Does Forrest have good documentation on getting it to work and installed?

Yes.

http://xml.apache.org/forrest/your-project.html

Basically untar it, set the FORREST_HOME and add the bin to the path, 
and it's done. To use the CVS version, just run "build" first.

To create a new site, cd into the dir and run "forrest seed".

> That is my concern.  If we offload the tools to a third party, I don't
> want to have to wrestle with the tool we choose.  Maven is a *build* tool,
> and from what I understand, can delegate to Forrest for doc generation.
> So as long as it is made **really*easy** for the user to get up and running,
> I am behind it.

Both Centipede and Maven can use Forrest for doc generation.
Centipede uses it standard, while Maven need a plugin.
Centipede also doenloads any plugin needed automatically.

IMHO using Centipede as a build tool coupled with Forrest is the easiest 
for the user, and the most flexible for us, but that's MHO. Gump also 
can run centipede projects, while Maven projects are run only using the 
generated ant file.

DISCLAIMER: I'm the original author of Centipede.

-- 
Nicola Ken Barozzi                   [email protected]
             - verba volant, scripta manent -
    (discussions get forgotten, just code remains)
---------------------------------------------------------------------