Re: [Wonder-disc] XML Publishing

[<max...@ma...>]

Hi Andrus,

>>> One of the ideas I borrowed from Jakarta is XML publishing.
>>
>> Mmmm, that is a really good idea. Once I have all of the JavaDoc done 
>> I will investigate this approach (unless someone wants to start 
>> sooner ;), sounds like it could really make our life much easier.
>
> I volunteer to do some work in this direction. Sorry if it takes longer 
> than planned - my life has been a bit crazy lately - looking for job, 
> moving out, Cayenne pending release, restoring my home network 
> destroyed by lightning strike, you name it.

Wow, best of luck in having things settle down a bit in the future. 
Having you help us lay the ground work for having a documentation and 
code Ant based build system would be outstanding.

> For now I would do this:
>
> - put all the XML stuff under ProjectWonder/xdocs in CVS. Structure 
> under xdocs would mirror the webserver docroot.
>
> - start a master build.xml under ProjectWonder/build. Since the scope 
> of Wonder is rather big, I envision a lot of buildfiles calling each 
> other, therefore I suggest creating a dedicated directory for all the 
> Ant stuff. Right now I will only put doc generation code in there.

That sounds like a great plan.

> The following things need to be decided before I can start:
>
> - Site look & feel. All the documents will inherit the main structure. 
> I would prefer (Anakia would handle best) a structure like Header, Left 
> Menu, Content Area, Footer. Content area would consist of sections and 
> subsections (for a sample structure, for instance look at 
> http://objectstyle.org/cayenne/userguide/quickstart/comline.html ). If 
> there is anyone with HTML/graphics design skills on the project, a 
> prototype page with bogus content would be nice.

Have you looked at http://wonder.sourceforge.net? Travis Cripps put 
together the look and feel of that site. He is also the one who donated 
the WOPayPal framework. I think that if we move the right hand side news 
column over to the left we can have a structure similar to the site you 
referenced. Travis any thoughts?

> - Decide which technology to use. Anakia 
> (http://jakarta.apache.org/velocity/anakia.html ) that I am familiar 
> with is very simple, but has its limitations. (For instance if you need 
> things like table of contents for the manual, you'd have to create it 
> yourself).

I won't even pretend that I know this technology. Anyone else have any 
thoughts? If you think Anakia can get the job done, you know the 
technology and you can help us lay the foundation, then I say those are 
good reasons to choose the technology.

> - And finally, my sourceforge id should be added to the list of 
> committers. My id is "mensk" (this is a historic name of my home city 
> in Belarus).

I have submitted your request to the admins of the project (we vote and 
then we'll get back to you).

Regards,
	Max