Grant of license

By contributing to this project, you agree to license your contributions under an MIT license and to waive any requirement to include an additional copyright notice.

Questions or problems?

Along with using the project issue tracker you can get help in real time on the #whatwg channel on irc.freenode.net.

Want to build, test, and run the code?

Follow the steps below to build, test, and run the checker such that you can open http://localhost:8888/ in a Web browser to use the checker Web UI.

1. Make sure you have git, python, and JDK 5 or later installed.

2. Set the JAVA_HOME environment variable:

    export JAVA_HOME=@@/PATH/TO/JDK/ON/YOUR/SYSTEM@@
   

   For example:

   • export JAVA_HOME=/usr/lib/jvm/java-6-openjdk (older Ubuntu)
   • export JAVA_HOME=/usr/lib/jvm/java-7-openjdk-amd64 (newer Ubuntu)
   • export JAVA_HOME=$(/usr/libexec/java_home) (Mac OS X)

3. Create a working directory:

    git clone https://github.com/validator/validator.git
   

4. Change into your working directory:

    cd validator
   

5. Start the build script:

    python ./build/build.py all; python ./build/build.py all
   

   Important: Yes, you must run the script twice the first time you build— to work around known issues that cause it to fail to complete when run from scratch in a fresh working directory. For subsequent builds you only have to run it once. And note that the first time you run it, it will need time to download ~300MB of dependencies.

The steps above will build, test, and run the checker such that you can open http://localhost:8888/ in a Web browser to use the checker Web UI.

Use python ./build/build.py --help to see command-line options for controlling the behavior of the script, as well as build-target names you can call separately; e.g.:

• python ./build/build.py build (to build only)
• python ./build/build.py build test (to build and test)
• python ./build/build.py run (to run only)

Confused about the code? Don’t know where to look?

If you’d like to contribute a bug fix or feature enhancement but aren’t sure where in the code to get started, here’s a brief annotated overview of the repository contents:

• build - scripts for building, testing, and running the checker
• htmlparser - (submodule) HTML parser
• jing-trang - (submodule) RelaxNG engine
• research-src - (unmaintained) experiments
• resources - catalogs used in fetching certain resources from local cache, etc.
• sample - (unmaintained) sample client scripts (Python) for, e.g., batch checking
• schema - RelaxNG schema-driver files + SVG & MathML RelaxNG schemas
• site - JavaScript & CSS for the checker Web UI + “About” page HTML source
• spec - HTML spec copies (used for emitting spec excerpts in validation messages)
• syntax - RelaxNG HTML schemas, HTML datatype library, & non-schema checker code
• src/nu/validator
  • client - various clients; e.g., SimpleCommandLineValidator, TestRunner
  • localentities - fetching resources from local cache; LocalCacheEntityResolver
  • messages - handling/emitting validation messages; MessageEmitterAdapter, etc.
  • servlet - core service logic; VerifierServletTransaction, etc.
  • source - handling/emitting "show source" output; SourceHandler & SourceCode
  • spec - parsing the HTML spec & emitting spec excerpts in validation messages
  • validation - entry point for 3rd-party code to use; SimpleDocumentValidator
• test-harness - (unmaintained) script (Python) for "full-stack" checker testing
• tests - (submodule) valid/invalid HTML docs for (regression) testing the checker
• util - library of utility code used in other parts of the checker sources
• xml-src - templates used for building HTML source of checker Web UI
• xmlparser - XML parser