Building and Deploying the Apache Harmony Website

Building

The following tools are required to build the Harmony website:

Note:

Some versions of JRE (e.g. Hotspot 1.5 on Windows) have problems converting Russian pages, in particular they corrupt UTF-8 cyrillic symbols. This can be easily detected, just open any generated Russian page in a browser and check if it contains unreadable symbols (like empty boxes). If you see them, you must use another JRE - Harmony is the natural choice. Set JAVA_HOME environment variable to point to an appropriate directory and you're done.

  1. Download the website source from Harmony subversion repository:
    2. $ svn checkout https://svn.apache.org/repos/asf/harmony/standard/site
  2. Change into the site directory: 
    $ cd site
  3. Run the default ant script target:
    4. $ ant

At this point, you have a complete generated website and documentation in the site/docs subdirectory. Open the index.html page and start browsing.

Making Changes

Making changes is straightforward. All edits are made to the contents of the xdocs/ subdirectory, and then rendered via the procedure above into the docs/ directory.

If you are a Harmony committer, you can simply checkin your changes. If you are not a committer, any updates and additions to the site are very welcome. Please see our Get Involved page for instructions on how to contribute your changes.

Deploying to Harmony Website

If you are a Harmony Committer, you can commit your changes into SVN and then publish to the project website. Once the changes are in SVN, do the following:

  1. SSH to minotaur.apache.org. Your login name will of course be your own.
    2. $ ssh geirm@minotaur.apache.org
  2. Go to the project website directory:
    3. $ cd /www/harmony.apache.org/
  3. Update the local copy in one of two ways: 
    $ svn update
    If you need to delete the HTML and re-checkout, use: 
    $ `cat UPDATE`

    4. Note

    The UPDATE file has the command performing a fresh svn checkout.

Back to top