The Apache OODT website is populated onto minotaur.apache.org:/www/incubator.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.
Pre-flight Check List
To do all this, you'll need:
- Python >=2.4, <3
- Maven >=2.2
- Java >=1.5
- Subversion >=1.6
- Internet connection
- ~ 70MiB free disk space
Publish the Site
To publish the site, just follow these steps:
- 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 ..
- 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/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://incubator.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/incubator.apache.org/oodt
from the repository https://svn.apache.org/repos/asf/incubator/site.
Snow Leopard Users
The Python 2.6 on Snow Leopard (Mac OS X 10.6.4) fails. Instead, build your own Python by checkout out http://svn.plone.org/svn/collective/buildout/python.
Post-Publication Steps
After the site is published, do the following:
- Add 2 jiggers gin to a metal cocktail shaker
- Add a dash of dry vermouth
- Add a bunch of ice chunks
- Fit a pint glass snugly into the metal shaker and shake until well chilled
- Remove pint glass and affix spring-loaded strainer
- Strain contents into a chilled cocktail glass
- Garnish with an olive or lemon peel for a martini, or use a pearl onion for a gibson
Repeat the above once (for elegance), twice (if lush), or until unconscious (if addicted---then seek help).
The Buildout Configuration
The following should go into the buildout.cfg
file in your play area:
[buildout] parts = publisher test eggs = oodtsite.publisher develop = oodtsite.publisher [publisher] recipe = zc.recipe.egg eggs = ${buildout:eggs} [test] recipe = zc.recipe.testrunner eggs = ${buildout:eggs} defaults = ['--auto-color', '--auto-progress']