Re: [MO-java-dev] Web site generation question

[Jeff M. <jef...@mk...>]

On Wed, 2003-05-14 at 16:11, Vincent Massol wrote:
> Hi,
>=20
> I've been trying the web site generation by going in doc/ and typing
> "ant -f site.xml site".
>=20
> However, I was surprised to find that the generated HTML in out/ does
> not come from the xdocs but from static HTML files in doc/html
>=20
> Could someone tell me what's the status and where the project is going
> for web site generation?

Basically we ran into problems with the xdocs stuff. As far as I know
style book has never had an official release and there was several
different incompatible version floating around at one time. This made it
very difficult for someone to just checkout the project and build the
website.

People were also saying they where put off editing the docs because of
the unfamiliar syntax.

Since all you really need for most of the site is a template to wrap the
menus around the pages it seemed fairly easy to use very simple html
pages and a little bit of java to wrap them in the template.

This way we get away from the external dependencies & people can use any
old html editor to edit the pages.

>=20
> Would you like to move to Maven for building the mockobjects project in
> the future? If so, I can very quickly migrate the doc generation to
> Maven and produce a site which looks like (http://maven.apache.org).
>=20

Don't have to much of a problem with this if you want to do it. Though
I'm getting lazy these days and resent having to install anything I
can't just get from www.jpackage.org (can't see maven there yet), and
I've looked on the maven site and can't see any mention of how you
manage adhoc pages within the site or what syntax is used. You've
probably got a much better handle on this than me.

--=20

jeff martin
information technologist
mkodo limited

mobile: 44 (0) 78 55 478 331
phone: 44 (0) 20 77 29 45 45
email: jef...@mk...

www.mkodo.com

73 Leonard St, London, EC2A 4QS. U.K