vnu-client(1)

NAME
vnu-client – HTTP client to a server instance of the Nu Html Checker

SYNOPSIS
JAVA_ARGS="-D[property=value]..." vnu-client [FILE]..

DESCRIPTION
vnu-client is the HTTP client to run from the command line to either send documents to a locally-running instance of the checker HTTP service (vnu-server) — for fast command-line checking — or to a remote instance anywhere on the Web.

OPTIONS

  FILE

        File you wish to send to the server for check.

PROPERTIES
When using the packaged HTTP client for sending documents to an instance of the checker HTTP service for checking, you can set Java system properties to control configuration options for the checker behavior.

Most of the properties listed below map to the common input parameters for the checker service, as documented at github.com/validator/validator/wiki/Service-»-Common-params (https://github.com/validator/validator/wiki/Service-%C2%BB-Common-params) .

  nu.validator.client.host=hostname

        Specifies the hostname of the checker for the client to connect to.
        default: "localhost"

        example: nu.validator.client.host=127.0.0.1

  nu.validator.client.port=port

        Specifies the port of the checker for the client to connect to.
        default: "8080"

        example: nu.validator.client.port=8888

  nu.validator.client.path=path

        Specifies the path of the checker for the client to connect to.
        default: "/vnu"

        example: nu.validator.client.path=/

  nu.validator.client.level=error

        Specifies the severity level of messages to report; to suppress
        warning-level messages, and only show error-level ones, set this property to
        "error".
        default: [unset]
        possible values: "error"

        example: nu.validator.client.level=error

  nu.validator.client.parser=parser

        Specifies which parser to use.
        default: "html"; or, for *.xhtml input files, "xml"
        possible values: [see information at URL below]

        https://github.com/validator/validator/wiki/Service-%C2%BB-Common-params#parser

  nu.validator.client.charset=encoding

        Specifies the encoding of the input document.
        default: [unset]

  nu.validator.client.content-type=content-type

        Specifies the content-type of the input document.
        default: "text/html"; or, for *.xhtml files, "application/xhtml+xml"

  nu.validator.client.out=output-format

        Specifies the output format for messages.
        default: "gnu"
        possible values: [see information at URL below]

        https://github.com/validator/validator/wiki/Service-%C2%BB-Common-params#out

  nu.validator.client.asciiquotes=boolean

        Specifies whether ASCII quotation marks are substituted for Unicode smart
        quotation marks in messages.
        default: "yes"
        possible values: "yes" or "no"

ENVIRONMENT VARIABLES
JAVA_ARGS

          Use JAVA_ARGS environment variable to set the properties (see PROPERTIES section).

EXAMPLES
To send FILE.html to an instance of the checker at http://html5.validator.nu/, invoke:

        JAVA_ARGS="-Dnu.validator.client.port=80 -Dnu.validator.client.host=html5.validator.nu -Dnu.validator.client.path=/" vnu-client FILE.html

To suppress warning-level messages and only show error-level ones by setting the value of the nu.validator.client.level system property to error, like this:

        JAVA_ARGS="-Dnu.validator.client.level=error" vnu-client FILE.html

SEE ALSO
vnu(1)