{"id":13596274,"url":"https://github.com/validator/validator","last_synced_at":"2026-04-01T20:31:43.573Z","repository":{"id":1217272,"uuid":"1133930","full_name":"validator/validator","owner":"validator","description":"The Nu Html Checker (vnu)","archived":false,"fork":false,"pushed_at":"2026-03-24T01:41:03.000Z","size":72858,"stargazers_count":1916,"open_issues_count":0,"forks_count":323,"subscribers_count":69,"default_branch":"main","last_synced_at":"2026-03-25T22:14:47.752Z","etag":null,"topics":["devtools","html-checker","html-linter","html-validation","linter","style-linter","w3c","web-development","web-standards","whatwg"],"latest_commit_sha":null,"homepage":"https://validator.github.io/validator/","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/validator.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":"DCO","cla":null},"funding":{"github":"validator"}},"created_at":"2010-12-03T02:00:23.000Z","updated_at":"2026-03-25T21:30:57.000Z","dependencies_parsed_at":"2024-01-14T20:15:42.728Z","dependency_job_id":"6a5a562d-1942-45d4-b62e-336ae53e45c9","html_url":"https://github.com/validator/validator","commit_stats":{"total_commits":4150,"total_committers":87,"mean_commits":"47.701149425287355","dds":0.3693975903614458,"last_synced_commit":"470d919b6c5a8f880e6976a1367b1412ca379c3d"},"previous_names":[],"tags_count":75,"template":false,"template_full_name":null,"purl":"pkg:github/validator/validator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/validator%2Fvalidator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/validator%2Fvalidator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/validator%2Fvalidator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/validator%2Fvalidator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/validator","download_url":"https://codeload.github.com/validator/validator/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/validator%2Fvalidator/sbom","scorecard":{"id":915291,"data":{"date":"2025-08-11","repo":{"name":"github.com/validator/validator","commit":"e5d4c688d0232f0c114bed6d00c079570d2ef36b"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":6.7,"checks":[{"name":"Maintained","score":10,"reason":"18 commit(s) and 7 issue activity found in the last 90 days -- score normalized to 10","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Code-Review","score":3,"reason":"Found 11/28 approved changesets -- score normalized to 3","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":10,"reason":"security policy file detected","details":["Info: security policy file detected: SECURITY.md:1","Info: Found linked content: SECURITY.md:1","Info: Found disclosure, vulnerability, and/or timelines in security policy: SECURITY.md:1","Info: Found text in security policy: SECURITY.md:1"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Info: jobLevel 'actions' permission set to 'read': .github/workflows/codeql-analysis.yml:16","Info: jobLevel 'contents' permission set to 'read': .github/workflows/codeql-analysis.yml:17","Info: jobLevel 'contents' permission set to 'read': .github/workflows/docker-push.yml:16","Warn: no topLevel permission defined: .github/workflows/build.yml:1","Warn: no topLevel permission defined: .github/workflows/codeql-analysis.yml:1","Warn: no topLevel permission defined: .github/workflows/docker-push.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Branch-Protection","score":-1,"reason":"internal error: error during branchesHandler.setup: internal error: githubv4.Query: Resource not accessible by integration","details":null,"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Signed-Releases","score":8,"reason":"5 out of the last 5 releases have a total of 5 signed artifacts.","details":["Info: signed release artifact: vnu.jar.asc: https://github.com/validator/validator/releases/tag/latest","Info: signed release artifact: vnu.jar_20.6.30.zip.asc: https://github.com/validator/validator/releases/tag/20.6.30","Info: signed release artifact: vnu.jar_20.3.16.zip.asc: https://github.com/validator/validator/releases/tag/20.3.16","Info: signed release artifact: vnu.jar_18.11.5.zip.asc: https://github.com/validator/validator/releases/tag/18.11.5","Info: signed release artifact: vnu.jar_18.8.29.zip.asc: https://github.com/validator/validator/releases/tag/18.8.29","Warn: release artifact latest does not have provenance: https://api.github.com/repos/validator/validator/releases/45729154","Warn: release artifact 20.6.30 does not have provenance: https://api.github.com/repos/validator/validator/releases/28051963","Warn: release artifact 20.3.16 does not have provenance: https://api.github.com/repos/validator/validator/releases/24547436","Warn: release artifact 18.11.5 does not have provenance: https://api.github.com/repos/validator/validator/releases/13821158","Warn: release artifact 18.8.29 does not have provenance: https://api.github.com/repos/validator/validator/releases/12634106"],"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Packaging","score":10,"reason":"packaging workflow detected","details":["Info: Project packages its releases by way of GitHub Actions.: .github/workflows/docker-push.yml:13"],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"SAST","score":7,"reason":"SAST tool detected but not run on all commits","details":["Info: SAST configuration detected: CodeQL","Warn: 5 commits out of 13 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yml:13: update your workflow using https://app.stepsecurity.io/secureworkflow/validator/validator/build.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yml:37: update your workflow using https://app.stepsecurity.io/secureworkflow/validator/validator/build.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yml:39: update your workflow using https://app.stepsecurity.io/secureworkflow/validator/validator/build.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yml:43: update your workflow using https://app.stepsecurity.io/secureworkflow/validator/validator/build.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/build.yml:78: update your workflow using https://app.stepsecurity.io/secureworkflow/validator/validator/build.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/build.yml:93: update your workflow using https://app.stepsecurity.io/secureworkflow/validator/validator/build.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/build.yml:105: update your workflow using https://app.stepsecurity.io/secureworkflow/validator/validator/build.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql-analysis.yml:27: update your workflow using https://app.stepsecurity.io/secureworkflow/validator/validator/codeql-analysis.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql-analysis.yml:30: update your workflow using https://app.stepsecurity.io/secureworkflow/validator/validator/codeql-analysis.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql-analysis.yml:35: update your workflow using https://app.stepsecurity.io/secureworkflow/validator/validator/codeql-analysis.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/docker-push.yml:20: update your workflow using https://app.stepsecurity.io/secureworkflow/validator/validator/docker-push.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/docker-push.yml:22: update your workflow using https://app.stepsecurity.io/secureworkflow/validator/validator/docker-push.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/docker-push.yml:29: update your workflow using https://app.stepsecurity.io/secureworkflow/validator/validator/docker-push.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/docker-push.yml:34: update your workflow using https://app.stepsecurity.io/secureworkflow/validator/validator/docker-push.yml/main?enable=pin","Warn: containerImage not pinned by hash: Dockerfile:1","Warn: containerImage not pinned by hash: Dockerfile:24: pin your Docker image by updating debian:stable-slim to debian:stable-slim@sha256:8810492a2dd16b7f59239c1e0cc1e56c1a1a5957d11f639776bd6798e795608b","Warn: containerImage not pinned by hash: build/Dockerfile.tagged:1: pin your Docker image by updating java:8u111-jre-alpine to java:8u111-jre-alpine@sha256:6a8cbe4335d1a5711a52912b684e30d6dbfab681a6733440ff7241b05a5deefd","Info:   0 out of   8 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   6 third-party GitHubAction dependencies pinned","Info:   0 out of   3 containerImage dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}}]},"last_synced_at":"2025-08-24T20:44:10.253Z","repository_id":1217272,"created_at":"2025-08-24T20:44:10.253Z","updated_at":"2025-08-24T20:44:10.253Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31291666,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-01T13:12:26.723Z","status":"ssl_error","status_checked_at":"2026-04-01T13:12:25.102Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["devtools","html-checker","html-linter","html-validation","linter","style-linter","w3c","web-development","web-standards","whatwg"],"created_at":"2024-08-01T16:02:14.173Z","updated_at":"2026-04-01T20:31:43.557Z","avatar_url":"https://github.com/validator.png","language":"Java","funding_links":["https://github.com/sponsors/validator"],"categories":["Java"],"sub_categories":[],"readme":"# The Nu Html Checker (vnu)\n\nWith the Nu Html Checker (vnu), you can:\n\n- [catch unintended mistakes in your HTML, CSS, and SVG][1]\n- [batch-check documents from the command line][2] and from other scripts/apps\n- [deploy your own instance of the vnu checker as a service][3] (like [validator.w3.org/nu][4])\n\n   [1]: https://validator.w3.org/nu/about.html#why-validate\n   [2]: #usage\n   [3]: #standalone-web-server\n   [4]: https://validator.w3.org/nu/\n\n## Usage\n\nYou can run the vnu checker with one of the invocations from the [vnu manual page](docs/vnu.1.md). For example:\n\n    java -jar ~/vnu.jar [OPTIONS]... FILES|DIRECTORY|URL...\n\nThe [OPTIONS section of the vnu manual page](docs/vnu.1.md#options) has details on all available options.\n\n## Releases\n\n\u003e [!IMPORTANT]\n\u003e **The [release named _“latest”_][0] is “production-ready” and is the only release you want to use.** This project no longer does “major” version-numbered releases. Release 20.6.30 (30 June 2020) was the final such release.\n\n[0]: https://github.com/validator/validator/releases/tag/latest\n\n## Sources\n\nThe vnu source code is available on [GitHub][5], as are [instructions on how to build, test, and run the code][6].\n\n   [5]: https://github.com/validator/validator\n   [6]: #build-instructions\n\n## Binaries and packages\n\nThe Nu Html Checker (vnu) is released upstream in these formats:\n\n- pre-compiled Linux, Windows, and macOS binaries that include an embedded Java runtime\n- `vnu.jar` — a portable version you can use on any system that has Java 11 or above installed\n- `vnu.war` — for [deploying the vnu checker service through a servlet container such as Tomcat][11]\n\n   [11]: #servlet-container\n\n\u003e [!NOTE]\n\u003e The `vnu.jar` and `vnu.war` files require you to have Java 11 or above installed. The pre-compiled Linux, Windows, and macOS binaries don’t require you to have any version of Java already installed at all.\n\nA [Dockerfile][7] (see **[Pulling the Docker image][36]** below) and [npm][8] and [brew][10] packages are also available.\n\n   [7]: https://ghcr.io/validator/validator\n   [8]: https://www.npmjs.com/package/vnu-jar\n   [10]: https://formulae.brew.sh/formula/vnu\n   [36]: #pulling-the-docker-image\n\nYou can [get the latest release][12] or run one of the following:\n\n- [`docker run -it --rm -p 8888:8888 ghcr.io/validator/validator:latest`][13]\n- [`jbang app install vnu@validator/validator`][15] \n- [`npm install vnu-jar`][14]\n- [`brew install vnu`][16]\n\n…and see the **[Usage](#usage)** and **[Web-based checking](#web-based-checking)** sections here. Or automate your checking with a frontend such as:\n\n   [12]: https://github.com/validator/validator/releases/tag/latest\n   [13]: https://github.com/validator/validator/pkgs/container/validator\n   [14]: https://www.npmjs.com/package/vnu-jar\n   [15]: https://www.jbang.dev/\n   [16]: https://libraries.io/homebrew/vnu\n\n- [Grunt plugin for HTML validation][18] or [Gulp plugin for HTML validation][19] or [Maven plugin for HTML validation][20]\n- [LMVTFY: Let Me Validate That For You][22] (auto-check JSFiddle/JSBin, etc., links in GitHub issue comments)\n\n   [18]: https://github.com/validator/grunt-html\n   [19]: https://github.com/validator/gulp-html\n   [20]: https://github.com/validator/maven-plugin\n   [22]: https://github.com/cvrebert/lmvtfy/\n\n## Web-based checking\n\nThe Nu Html Checker (vnu) — along with being usable as [a standalone command-line client][24] — can be run as an HTTP service, similar to [validator.w3.org/nu][25], for browser-based checking of HTML documents, CSS stylesheets, and SVG images over the Web. To that end, the vnu checker is released as several separate packages:\n\n   [24]: #usage\n   [25]: https://validator.w3.org/nu/\n\n- Linux, Windows, and macOS binaries for deploying a self-contained service on any system\n- `vnu.jar` for deploying a self-contained service on a system with Java installed\n- `vnu.war` for deploying to a servlet container such as Tomcat\n\nAll deployments expose a REST API that enables checking of HTML documents, CSS stylesheets, and SVG images from other clients, not just web browsers. And the Linux, Windows, and macOS binaries and `vnu.jar` package also include a simple HTTP client that enables you to either send documents to a locally-running instance of the vnu checker HTTP service — for fast command-line checking — or to any remote instance of the vnu checker HTTP service running anywhere on the Web.\n\nThe [latest releases of the Linux, Windows, and macOS binaries and vnu.jar and vnu.war packages][26] are available from the `validator` project at github. The following are detailed instructions on using them.\n\n   [26]: https://github.com/validator/validator/releases/tag/latest\n\n\u003e [!NOTE]\n\u003e Throughout these instructions, replace `~/vnu.jar` with the actual path to that jar file on your system, and replace `vnu-runtime-image/bin/java` and `vnu-runtime-image\\bin\\java.exe` with the actual path to the vnu `java` or `java.exe` program on your system — or if you add the `vnu-runtime-image/bin` or `vnu-runtime-image\\bin` directory your system `PATH` environment variable, you can invoke the vnu checker with just `java nu.validator.servlet.Main 8888`.\n\n### Standalone web server\n\nSee [vnu-server](docs/vnu-server.1.md) for invocation manual page.\n\n### Servlet container\n\nTo run the vnu checker inside of an existing servlet container such as Apache Tomcat you will need to deploy the `vnu.war` file to that server following its documentation. For example, on Apache Tomcat you could do this using the [Manager][30] application or simply by copying the file to the `webapps` directory (since that is the default `appBase` setting). Typically you would see a message similar to the following in the `catalina.out` log file.\n\n   [30]: https://tomcat.apache.org/tomcat-8.0-doc/manager-howto.html\n\n    May 7, 2014 4:42:04 PM org.apache.catalina.startup.HostConfig deployWAR\n    INFO: Deploying web application archive /var/lib/tomcat7/webapps/vnu.war\n\nAssuming your servlet container is configured to receive HTTP requests sent to `localhost` on port `80` and the context root of this application is `vnu` (often the default behavior is to use the WAR file's filename as the context root unless one is explicitly specified) you should be able to access the application by connecting to [http://localhost/vnu/][31].\n\n   [31]: http://localhost/vnu/\n\n\u003e [!NOTE]\n\u003e You may want to customize the `/WEB-INF/web.xml` file inside the WAR file (you can use any ZIP-handling program) to modify the servlet filter configuration. For example, if you wanted to disable the inbound-size-limit filter, you could comment out that filter like this:\n\n    \u003c!--\n      \u003cfilter\u003e\n          \u003cfilter-name\u003einbound-size-limit-filter\u003c/filter-name\u003e\n          \u003cfilter-class\u003enu.validator.servlet.InboundSizeLimitFilter\u003c/filter-class\u003e\n      \u003c/filter\u003e\n      \u003cfilter-mapping\u003e\n          \u003cfilter-name\u003einbound-size-limit-filter\u003c/filter-name\u003e\n          \u003curl-pattern\u003e/*\u003c/url-pattern\u003e\n      \u003c/filter-mapping\u003e\n    --\u003e\n\n### HTTP client (for fast command-line checking)\n\nThe vnu checker is packaged with an HTTP client you can use from the command line to either send documents to a locally-running instance of the vnu checker HTTP service — for fast command-line checking — or to a remote instance anywhere on the Web.\n\nTo check documents locally using the packaged HTTP client, do this:\n\n  1. Start up the vnu checker as a local HTTP service, as described in the [**Standalone web server**][37] section.\n\n  2. Invoke the HTTP client like from the commandline according to [vnu-client](docs/vnu-client.1.md) manual page.\n\n   [37]: #standalone-web-server\n\n## Pulling the Docker image\n\nYou can pull the vnu Docker image from [https://ghcr.io/validator/validator][34] in the GitHub container registry.\n\n   [34]: https://ghcr.io/validator/validator\n\nTo pull and run the latest version of the vnu checker:\n\n      docker run -it --rm -p 8888:8888 ghcr.io/validator/validator:latest\n\nTo pull and run a specific tag/version of the vnu checker from the container registry — for example, the `17.11.1` version:\n\n      docker run -it --rm -p 8888:8888 ghcr.io/validator/validator:17.11.1\n\nTo bind the vnu checker to a specific address (rather than have it listening on all interfaces):\n\n      docker run -it --rm -p 128.30.52.73:8888:8888 ghcr.io/validator/validator:latest\n\nTo make the vnu checker run with a connection timeout and socket timeout different from the default 5 seconds, use the `CONNECTION_TIMEOUT_SECONDS` and `SOCKET_TIMEOUT_SECONDS` environment variables:\n\n      docker run -it --rm \\\n         -e CONNECTION_TIMEOUT_SECONDS=15 \\\n         -e SOCKET_TIMEOUT_SECONDS=15 \\\n         -p 8888:8888 \\\n         validator/validator\n\nTo make the vnu checker run with particular Java system properties set, use the `JAVA_TOOL_OPTIONS` environment variable:\n\n      docker run -it --rm \\\n         -e JAVA_TOOL_OPTIONS=-Dnu.validator.client.asciiquotes=yes  \\\n         -p 8888:8888 \\\n         validator/validator\n\nTo define a service named `vnu` for use with `docker compose`, create a Compose file named `docker-compose.yml` (for example), with contents such as the following:\n\n      version: '2' services:\n        vnu:\n          image: validator/validator ports:\n            - \"8888:8888\"\n          network_mode: \"host\" #so \"localhost\" refers to the host machine.\n\nTo run the vnu command-line checker provided by a Docker image on all the HTML files in the `/var/www/html` directory:\n\n      docker run --rm -v /var/www/html:/data ghcr.io/validator/validator:latest vnu --skip-non-html /data\n\n## Build instructions\n\nFollow the steps below to build, test, and run the vnu checker such that you can open `http://0.0.0.0:8888/` in a Web browser to use the vnu checker Web UI.\n\n  1. Make sure you have git, python, a 64-bit JDK 11 or above, [ant](https://ant.apache.org/manual/install.html), and [maven](https://maven.apache.org/install.html) installed.\n\n  2. Set the `JAVA_HOME` environment variable:\n\n         export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64\n\n         export JAVA_HOME=$(/usr/libexec/java_home)            \u003c-- macOS\n\n  3. Create a working directory:\n\n         git clone https://github.com/validator/validator.git\n\n  4. Change into your working directory:\n\n         cd validator\n\n  5. Start the `checker.py` Python script:\n\n         python ./checker.py all\n\nThe first time you run the `checker.py` Python script, you’ll need to be online and the build will need time to download several megabytes of dependencies.\n\nAlternatively, if you wish to first download all dependencies, and build later when **offline**:\n\n1. Use the `dldeps` task to download\n\n        python ./checker.py dldeps\n\n1. For all operations when offline, use the `--offline` option (place it before the task name)\n\n        python ./checker.py --offline all\n\n\nThe steps above will build, test, and run the vnu checker such that you can open `http://0.0.0.0:8888/` in a Web browser to use the vnu checker Web UI.\n\n\u003e [!WARNING]\n\u003e Future checker releases will bind by default to the address `127.0.0.1`. Your checker deployment might become unreachable unless you use the `--bind-address` option to bind to a different address:\n\n    python ./checker.py --bind-address=128.30.52.73 all\n\nUse `python ./checker.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.:\n\n    python ./checker.py build       # to build only\n\n    python ./checker.py build test  # to build and test\n\n    python ./checker.py run         # to run only\n\n    python ./checker.py jar         # to compile vnu.jar\n\n## Embedded Java usage\n\nMaven:\n\n    \u003cdependency\u003e\n        \u003cgroupId\u003enu.validator\u003c/groupId\u003e\n        \u003cartifactId\u003evalidator\u003c/artifactId\u003e\n        \u003cversion\u003eNN.NN.NN\u003c/version\u003e\n        \u003cscope\u003etest\u003c/scope\u003e\n    \u003c/dependency\u003e\n\nGradle:\n\n    testImplementation 'nu.validator:validator:NN.NN.NN'\n\n\u003e [!IMPORTANT]\n\u003e The `nu.validator:validator` artifact bundles all required dependencies, including `nu.validator:htmlparser`. Do not add `htmlparser` as a separate dependency; doing so will cause duplicate classes on the classpath. If you need to use the `htmlparser` classes for other purposes, just use the ones provided by the `nu.validator:validator` artifact.\n\nBasic usage java code:\n\n    String html = ...\n    EmbeddedValidator validator = new EmbeddedValidator();\n    validator.setOutputFormat( EmbeddedValidator.OutputFormat.GNU );\n    try {\n        String output = validator.validate( new ByteArrayInputStream( html.getBytes( StandardCharsets.UTF_8 ) ) );\n        if (!output.isEmpty())\n            throw new Exception( output ); //validation failed\n    } catch (SAXException e) {\n        throw new Exception( \"Cannot validate html\", e );\n    }\n\nUsing a different output format requires the code to be adjusted.\n\n## Additional documentation\n\nAdditional documentation is available on the [vnu wiki](https://github.com/validator/validator/wiki/).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvalidator%2Fvalidator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvalidator%2Fvalidator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvalidator%2Fvalidator/lists"}