Source

vnu / README

Full commit
## How to download, build, and run the validator

  1. First, set the JAVA_HOME environment variable properly.

On Ubuntu:


      export JAVA_HOME=/usr/lib/jvm/java-6-openjdk

On Mac OS X:


      export JAVA_HTML=/Library/Java/Home

  2. Create a validator workspace.


      mkdir checker

      cd checker

      hg clone https://bitbucket.org/validator/build build


The above steps creates a `checker` directory in which the build script will
create other subdirectories, and downloads the `build.py` script itself into a
`build` subdirectory in your `checker` directory.

  3. > Run the build script.


      python build/build.py all

      python build/build.py all


Yes, the last line is there twice intentionally. Running the script twice tends
to fix a `ClassCastException` on the first run.

The above steps will download, build and run the system at
http://localhost:8888/. For other options, please run `python build/build.py
--help` instead.

Please note that the dependencies are big. The script will spend time
downloading stuff. The script requires Python, Mercurial, Subversion and JDK 5
or later (JDK 6 and Hardy’s OpenJDK work). (Tested on Mac OS X and Ubuntu with
the openjdk-6-jdk package.)

Note: The script wants to see a Sun-compatible jar executable. Debian fastjar
will not work.

## Deployment

The above example starts a standalone HTTP server with debug messages printed to
the console. To use AJP13 instead, use `--ajp=on`. A log4j configuration for
deployment can be given using the `--log4j=` option. There is a sample file in
`validator/log4j-deployment-sample.properties`. The directory `extras/` is
searched for additional jars for the classpath. For example, if you configure
log4j to send email, you should put the Java Mail API and JavaBeans Activation
Framework jars in extras/.

## jars

[more info later]

foo here

    bar here