Fwd: Re: Implement svnpubsub using "mvn site" ?

[Eric Charles <er...@u-mangate.com>]

fyi

-------- Original Message --------
Subject: Re: Implement svnpubsub using "mvn site" ?
Date: Thu, 16 Feb 2012 09:22:27 -0800 (PST)
From: Joe Schaefer <jo...@yahoo.com>
Reply-To: Joe Schaefer <jo...@yahoo.com>
To: Eric Charles <er...@u-mangate.com>,  Apache Infrastructure 
<in...@apache.org>

>________________________________
> From: Eric Charles <er...@u-mangate.com>
>To: Apache Infrastructure <in...@apache.org>
>Sent: Thursday, February 16, 2012 3:34 AM
>Subject: Re: Implement svnpubsub using "mvn site" ?
>
>Hi Joe,
>All subprojects (and the main project) sites are built with mvn site (xml to html).
>
>- We have a 'site' project where we put the generated html, and the we made 'svn up' on people.apache.org.
>- For whatever reason, we came to scp only the changed files/sites, so our 'site' project in svn in no more up-to-date...
>- Optionally, we use mvn site-deploy directly (it has worked a few times, but now seems broken due to bade credential).


Eww, let's see if we can throw most of that mess away and consolidate 
the James
site builds into a single CMS-backed website.  First we need to create a

james/site/trunk/content


directory in svn that contains all the xml files that serve as sources 
for the entire site,
including the generated javadocs.  Individual subprojects can checkout 
and make changes to
whatever subtree of that directory they are interested in, and they can 
use svn externals
to map the "javadoc" output subdirs back into their pristine source code 
trees.  Subprojects
then would only be responsible for building their local documentation 
and checking it back in
to the svn:external based subdir that originates in the 
james/site/trunk/content tree.

The rest is all handled cleanly by the CMS once someone figures out how 
to instruct maven
to build a local checkout of james/site/trunk/content to a target 
directory specified at runtime.

Whatever auxiliary config files, executables and libraries can all be 
placed alongside
the james/site/trunk/content dir somewhere.  The CMS will always start 
the site build
using james/site/trunk as the current working directory.  Those prebuilt 
javadocs in
the content/ dir should simply be treated like any javascript, css, or 
image file and
copied over unmodified.


---------------------------------------------------------------------
To unsubscribe, e-mail: server-dev-unsubscribe@james.apache.org
For additional commands, e-mail: server-dev-help@james.apache.org