You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 8 Next »

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/site.

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:

  1. Make a play area: mkdir oodt-site
  2. Go there: cd oodt-site
  3. Grab the buildout bootstrapper: curl -LO 'http://svn.zope.org/*checkout*/zc.buildout/trunk/bootstrap/bootstrap.py'
  4. Check out the static HTML docs: svn co https://svn.apache.org/repos/asf/incubator/oodt/docs/site static
  5. Make and commit any last-minute changes to the docs in static
  6. 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
  7. 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.
  8. Check out the oodtsite.publisher: svn co https://svn.apache.org/repos/asf/incubator/oodt/tools/oodtsite.publisher/trunk oodtsite.publisher
  9. Check out the final destination of the site: svn co https://svn.apache.org/repos/asf/incubator/oodt/site
  10. Create buildout.cfg from the contents listed under "The Buildout Configuration" below.
  11. Bootstrap the buildout: python bootstrap.py -d
  12. Build it out: bin/buildout
  13. Make sure the publisher works: bin/test
  14. Publish: bin/oodtsitepublish --base=http://incubator.apache.org/oodt --target=site static oodt
  15. 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 svn-checking out http://svn.plone.org/svn/collective/buildout/python.

Post-Publication Steps

After the site is published, do the following:

  1. Add 2 jiggers gin to a metal cocktail shaker
  2. Add a dash of dry vermouth
  3. Add a bunch of ice chunks
  4. Fit a pint glass snugly into the metal shaker and shake until well chilled
  5. Remove pint glass and affix spring-loaded strainer
  6. Strain contents into a chilled cocktail glass
  7. 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.cfg
[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']
  • No labels