The Apache OODT website is populated onto minotaur.apache.org:/www/incubatoroodt.apache.org /oodt by an "svn checkout" from the Apache Subversion repository at https://svn.apache.org/repos/asf/incubator/oodt. To populate that directory, we feed our Maven artifacts and some static HTML documentation into some Python code. That code then generates files that can then be checked into https://svn.apache.org/repos/asf/incubator/oodt/site.
Pre-flight Check List
To do all this, you'll need:
...
- Make a play area:
mkdir oodt-site
- Go there:
cd oodt-site
- Grab the buildout bootstrapper:
curl -LO 'http://svn.zope.org/
*checkout*
/zc.buildout/trunk/bootstrap/bootstrap.py'
- Check out the static HTML docs:
svn co
https://svn.apache.org/repos/asf/incubator/oodt/docs/site
static
- Make and commit any last-minute changes to the docs in
static
- Check out the OODT source code (replace
trunk
with a tag as appropriate):svn co
https://svn.apache.org/repos/asf/incubator/oodt/trunk
oodt
- Build the Maven site artifacts:
cd oodt; mvn site; cd ..
- NOTE if this part fails for you on any OODT dependencies, it's likely that you haven't installed all of them yet; so a pre-requisite to this step would be to run mvn install from the cd oodt; directory. - Check out the
oodtsite.publisher
:svn co
https://svn.apache.org/repos/asf/incubator/oodt/tools/oodtsite.publisher/trunk
oodtsite.publisher
- Check out the final destination of the site:
svn co
https://svn.apache.org/repos/asf/incubator/oodt/site
- Create
buildout.cfg
from the contents listed under "The Buildout Configuration" below. - Bootstrap the buildout:
python bootstrap.py -d
- Build it out:
bin/buildout
- Make sure the publisher works:
bin/test
- Publish:
bin/oodtsitepublish --base=
http://incubatoroodt.apache.org/oodt
--target=site static oodt
- Commit:
cd site; svn add *; svn ci
Now you can tell someone with permissions on minotaur.apache.org to "svn checkout" or "svn update" in the /www/incubatoroodt.apache.org/oodt
from the repository https://svn.apache.org/repos/asf/incubatoroodt/site.
Snow Leopard Users
The Python 2.6 on Snow Leopard (Mac OS X 10.6.4) fails. Instead, build your own Python by svn-checking out http://svn.plone.org/svn/collective/buildout/python.
...