• Home
• nu.validator
• validator
• 15.3.11
• source code
• cli-help

×

Project download

Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance.
Project price only 1 $

You can buy this project and download/modify it how often you want.

nu.validator.localentities.files.cli-help Maven / Gradle / Ivy

# The Nu HTML Checker (v.Nu) [![Nu HTML Checker chat room][1]][2]

   [1]: https://goo.gl/1kHqwI
   [2]: https://gitter.im/validator/validator

The Nu HTML Checker (v.Nu) is a name for the backend of [html5.validator.nu][3],
[validator.w3.org/nu][4], and the HTML5 facet of the legacy [W3C Validator][5].
Its [source code is available][6], as are [instructions on how to build, test,
and run the code][7]. The checker is released as two separate packages:

   [3]: https://html5.validator.nu
   [4]: http://validator.w3.org/nu/
   [5]: http://validator.w3.org
   [6]: https://github.com/validator/validator
   [7]: https://validator.github.io/validator/#build-instructions

  * `vnu.jar` is a portable standalone version for [batch-checking documents
  from the command line][8] and from other scripts/apps, or for [deploying the
  checker as a self-contained service][9]

  * `vnu.war` is for [deploying the checker service through a servlet container
  such as Tomcat][10]

   [8]: https://validator.github.io/validator/#usage
   [9]: https://validator.github.io/validator/#standalone
   [10]: https://validator.github.io/validator/#servlet

To use the Nu HTML Checker on your own, [get the latest release][11] and see the
**Usage** and **Web-based checking** sections belowーor alternatively, consider
automating your HTML checking with a frontend such as:

   [11]: https://github.com/validator/validator/releases/latest

  * [Grunt plugin for HTML validation][12]

  * [Gulp plugin for HTML validation][13]

  * [HTML5 Validator Integration for Travis CI][14] (auto-check documents pushed
  to a github repo)

  * [LMVTFY: Let Me Validate That For You][15] (auto-check HTML of
  JSFiddle/JSBin etc. links in github issue comments)

   [12]: https://github.com/jzaefferer/grunt-html
   [13]: https://github.com/watilde/gulp-html
   [14]: https://github.com/svenkreiss/html5validator
   [15]: https://github.com/cvrebert/lmvtfy/

## Usage

You can use the `vnu.jar` HTML checker as an executable for command-line
checking of documents by invoking it like this:

      java -jar ~/vnu.jar [--errors-only] [--no-stream]
           [--format gnu|xml|json|text] [--help] [--html] [--verbose]
           [--version] FILES

**Note:** In these instructions, replace _"~/vnu.jar"_ with the actual path to
the file on your system.

To check one or more documents from the command line:

      java -jar ~/vnu.jar FILE.html FILE2.html FILE3.HTML FILE4.html...

**Note:** If you get a `StackOverflowError` error when using the vnu.jar file,
try adjusting the thread stack size by providing the `-Xss` option to java:

      java -Xss512k -jar ~/vnu.jar FILE.html...

To check all documents in a particular directory:

      java -jar ~/vnu.jar some-directory-name/

To check all documents in a particular directory, skipping any documents whose
names don’t end with the extensions `.html`, `.htm`, `.xhtml`, or `.xht`:

      java -jar ~/vnu.jar --skip-non-html some-directory-name/

To check a Web document:

      java -jar ~/vnu.jar _URL_

      example: java -jar ~/vnu.jar http://example.com/foo

To check standard input:

      java -jar ~/vnu.jar -

      example: echo '