Nu Html Checker(v.Nu)는 HTML, CSS 및 SVG에서 의도하지 않은 실수를 찾아내는 데 도움이 됩니다. 명령줄과 다른 스크립트/앱에서 문서를 일괄 검사하고 검사기의 자체 인스턴스를 서비스(예: validator.w3.org/nu)로 배포할 수 있습니다. 코드를 빌드, 테스트 및 실행하는 방법에 대한 지침과 마찬가지로 소스 코드도 제공됩니다.
Dockerfile(아래 Docker 이미지 가져오기 참조)과 npm, pip 및 Brew 패키지도 사용할 수 있습니다.
다음 형식으로 업스트림으로 릴리스됩니다.
내장된 Java 런타임을 포함하는 사전 컴파일된 Linux, Windows 및 macOS 바이너리
vnu.jar
— Java 11 이상이 설치된 모든 시스템에서 사용할 수 있는 휴대용 버전
vnu.war
— Tomcat과 같은 서블릿 컨테이너를 통해 검사기 서비스 배포용
참고: vnu.jar 및 vnu.war 파일을 사용하려면 Java 11 이상이 설치되어 있어야 합니다. 사전 컴파일된 Linux, Windows 및 macOS 바이너리에는 Java 버전이 이미 설치되어 있을 필요가 전혀 없습니다.
최신 릴리스를 다운로드하거나 docker run -it --rm -p 8888:8888 ghcr.io/validator/validator:latest
, npm install vnu-jar
, npm install --registry=https://npm.pkg.github.com @validator/vnu-jar
, brew install vnu
또는 pip install html5validator
실행하고 아래의 사용 및 웹 기반 확인 섹션을 참조하세요. 또는 다음과 같은 프런트엔드를 사용하여 문서 확인을 자동화하세요.
HTML 유효성 검사를 위한 Grunt 플러그인 또는 HTML 유효성 검사를 위한 Gulp 플러그인 또는 HTML 유효성 검사를 위한 Maven 플러그인
html5validator pip
패키지(Travis CI, CircleCI, CodeShip, Jekyll, Pelican 등에 통합용)
LMVTFY: 확인해 보겠습니다(JSFiddle/JSBin 등, GitHub 문제 설명의 링크 자동 확인).
다음 호출 중 하나를 사용하여 검사기를 실행합니다.
• vnu-runtime-image/bin/vnu OPTIONS FILES
(Linux 또는 macOS)
• vnu-runtime-imagebinvnu.bat OPTIONS FILES
(Windows)
• java -jar ~/vnu.jar OPTIONS FILES
(Java8+가 설치된 모든 시스템)
...여기서 FILES
는 확인할 문서이고 OPTIONS
다음 옵션 중 0개 이상입니다.
--errors-only --Werror --exit-zero-always --stdout --asciiquotes
--user-agent USER_AGENT --no-langdetect --no-stream --filterfile FILENAME
--filterpattern PATTERN --css --skip-non-css --also-check-css --svg
--skip-non-svg --also-check-svg --xml --html --skip-non-html
--format gnu|xml|json|text --help --verbose --version
아래의 옵션 섹션에서는 각 옵션에 대한 세부 정보를 제공하며, 이 섹션의 나머지 부분에서는 몇 가지 구체적인 예를 제공합니다.
참고: 이 예제 전체에서 ~/vnu.jar
시스템에 있는 해당 jar 파일의 실제 경로로 바꾸고, vnu-runtime-image/bin/vnu
및 vnu-runtime-imagebinvnu.bat
실제 경로로 바꾸세요. 시스템의 vnu
또는 vnu.bat
프로그램 경로 — 또는 시스템 PATH
환경 변수 vnu-runtime-image/bin
또는 vnu-runtime-imagebin
디렉토리를 추가하는 경우 vnu
만으로 검사기를 호출할 수 있습니다.
명령줄에서 하나 이상의 문서를 확인하려면:
vnu-runtime-image/bin/vnu FILE.html FILE2.html FILE3.html...
vnu-runtime-imagebinvnu.bat FILE.html FILE2.html FILE3.html...
java -jar ~/vnu.jar FILE.html FILE2.html FILE3.html...
참고: 검사기를 호출할 때 StackOverflowError
오류가 발생하는 경우 java에 -Xss
옵션을 제공하여 스레드 스택 크기를 조정해 보세요.
java -Xss512k -jar ~/vnu.jar ...
vnu-runtime-image/bin/java -Xss512k
-m vnu/nu.validator.client.SimpleCommandLineValidator ...
특정 디렉터리 DIRECTORY_PATH
의 모든 문서를 HTML로 확인하려면 다음을 수행하세요.
java -jar ~/vnu.jar DIRECTORY_PATH
vnu-runtime-image/bin/vnu DIRECTORY_PATH
vnu-runtime-imagebinvnu.bat DIRECTORY_PATH
참고: 이 섹션의 예에서는 시스템 PATH
환경 변수에 vnu-runtime-image/bin
또는 vnu-runtime-imagebin
디렉터리가 있다고 가정합니다. 대신 jar 파일을 사용하는 경우 예제의 vnu
java -jar ~/vnu.jar
로 바꾸세요.
특정 디렉터리 DIRECTORY_PATH
의 모든 문서를 HTML로 확인하지만 이름이 확장자 .html
, .htm
, .xhtml
또는 .xht
로 끝나지 않는 문서를 건너뛰려면 다음을 수행하세요.
vnu --skip-non-html DIRECTORY_PATH
특정 디렉토리의 모든 문서를 CSS로 확인하려면:
vnu --css DIRECTORY_PATH
특정 디렉토리의 모든 문서를 CSS로 확인하지만 이름이 .css
확장자로 끝나지 않는 문서를 건너뛰려면 다음을 수행하세요.
vnu --skip-non-css DIRECTORY_PATH
이름이 .css
확장자로 끝나는 문서를 CSS로 확인하고 다른 모든 문서를 HTML로 확인하여 특정 디렉터리의 모든 문서를 확인하려면 다음을 수행하세요.
vnu --also-check-css DIRECTORY_PATH
특정 디렉토리의 모든 문서를 SVG로 확인하려면:
vnu --svg DIRECTORY_PATH
특정 디렉토리의 모든 문서를 SVG로 확인하되 이름이 .svg
확장자로 끝나지 않는 문서를 건너뛰려면 다음을 수행하세요.
vnu --skip-non-svg DIRECTORY_PATH
이름이 .svg
확장자로 끝나는 문서를 SVG로 확인하고 다른 모든 문서를 HTML로 확인하여 특정 디렉터리의 모든 문서를 확인하려면:
vnu --also-check-svg DIRECTORY_PATH
웹 문서를 확인하려면:
vnu _URL_
example: vnu http://example.com/foo
표준 입력을 확인하려면 다음을 수행하십시오.
vnu -
example:
echo '<!doctype html><title>...' | vnu -
echo '<!doctype html><title>...' | java -jar ~/vnu.jar -
이 섹션에 설명된 대로 명령줄에서 사용하는 경우 검사기는 다음 옵션을 제공합니다.
Specifies whether ASCII quotation marks are substituted for Unicode smart
quotation marks in messages.
default: [unset; Unicode smart quotation marks are used in messages]
Specifies that only error-level messages and non-document-error messages are
reported (so that warnings and info messages are not reported).
default: [unset; all messages reported, including warnings & info messages]
Makes the checker exit non-zero if any warnings are encountered (even if
there are no errors).
default: [unset; checker exits zero if only warnings are encountered]
Makes the checker exit zero even if errors are reported for any documents.
default: [unset; checker exits 1 if errors are reported for any documents]
Makes the checker report errors and warnings to stdout rather than stderr.
default: [unset; checker reports errors and warnings to stderr]
Specifies a filename. Each line of the file contains either a regular
expression or starts with "#" to indicate the line is a comment. Any error
message or warning message that matches a regular expression in the file is
filtered out (dropped/suppressed).
default: [unset; checker does no message filtering]
Specifies a regular expression. Any error message or warning message that
matches the regular expression is filtered out (dropped/suppressed).
As with all other checker options, this option may only be specified once.
So to filter multiple error messages or warning messages, you must provide a
single regular expression that will match all the messages. The typical way
to do that for regular expressions is to OR multiple patterns together using
the "|" character.
default: [unset; checker does no message filtering]
Specifies the output format for reporting the results.
default: "gnu"
possible values: "gnu", "xml", "json", "text" [see information at URL below]
https://github.com/validator/validator/wiki/Service-%C2%BB-Common-params#out
Shows detailed usage information.
Check documents as CSS but skip documents that don’t have *.css extensions.
default: [unset; all documents found are checked]
Force all documents to be checked as CSS, regardless of extension.
default: [unset]
Check documents as SVG but skip documents that don’t have *.svg extensions.
default: [unset; all documents found are checked]
Force all documents to be checked as SVG, regardless of extension.
default: [unset]
Skip documents that don’t have *.html, *.htm, *.xhtml, or *.xht extensions.
default: [unset; all documents found are checked, regardless of extension]
Forces any *.xhtml or *.xht documents to be parsed using the HTML parser.
default: [unset; XML parser is used for *.xhtml and *.xht documents]
Forces any *.html documents to be parsed using the XML parser.
default: [unset; HTML parser is used for *.html documents]
Check CSS documents (in addition to checking HTML documents).
default: [unset; no documents are checked as CSS]
Check SVG documents (in addition to checking HTML documents).
default: [unset; no documents are checked as SVG]
Specifies the value of the User-Agent request header to send when checking
HTTPS/HTTP URLs.
default: "Validator.nu/LV"
Disables language detection, so that documents are not checked for missing
or mislabeled html[lang] attributes.
default: [unset; language detection & html[lang] checking are performed]
Forces all documents to be be parsed in buffered mode instead of streaming
mode (causes some parse errors to be treated as non-fatal document errors
instead of as fatal document errors).
default: [unset; non-streamable parse errors cause fatal document errors]
Specifies "verbose" output. (Currently this just means that the names of
files being checked are written to stdout.)
default: [unset; output is not verbose]
Shows the checker version number.
Nu HTML 검사기는 독립 실행형 명령줄 클라이언트로 사용할 수 있을 뿐만 아니라 HTML 문서, CSS 스타일시트 및 SVG 이미지의 브라우저 기반 검사를 위해 validator.w3.org/nu와 유사한 HTTP 서비스로 실행될 수 있습니다. 웹을 통해. 이를 위해 검사기는 여러 개의 별도 패키지로 출시됩니다.
모든 시스템에 간단한 자체 포함 서비스로 검사기를 배포하기 위한 Linux, Windows 및 macOS 바이너리
Java가 설치된 시스템에 간단한 자체 포함 서비스로 검사기를 배포하기 위한 vnu.jar
Tomcat과 같은 서블릿 컨테이너에 검사기를 배포하기 위한 vnu.war
모든 배포는 웹 브라우저뿐만 아니라 다른 클라이언트의 HTML 문서, CSS 스타일시트 및 SVG 이미지를 확인할 수 있는 REST API를 노출합니다. 그리고 Linux, Windows, macOS 바이너리와 vnu.jar
패키지에는 빠른 명령줄 확인을 위해 로컬에서 실행되는 검사기 HTTP 서비스 인스턴스로 문서를 보내거나 원격으로 문서를 보낼 수 있는 간단한 HTTP 클라이언트도 포함되어 있습니다. 웹 어디에서나 실행되는 검사기 HTTP 서비스의 인스턴스입니다.
Linux, Windows, macOS 바이너리와 vnu.jar 및 vnu.war 패키지의 최신 릴리스는 github의 validator
프로젝트에서 사용할 수 있습니다. 다음은 사용에 대한 자세한 지침입니다.
참고: 이 지침 전체에서 ~/vnu.jar
시스템에 있는 해당 jar 파일의 실제 경로로 바꾸고, vnu-runtime-image/bin/java
및 vnu-runtime-imagebinjava.exe
실제 경로로 바꾸십시오. 시스템의 검사기 java
또는 java.exe
프로그램 경로 — 또는 시스템 PATH
환경 변수에 vnu-runtime-image/bin
또는 vnu-runtime-imagebin
디렉토리를 추가하면 java nu.validator.servlet.Main 8888
만으로 검사기를 호출할 수 있습니다. java nu.validator.servlet.Main 8888
.
검사기를 독립형 서비스(내장 Jetty 서버 사용)로 실행하려면 새 터미널 창을 열고 다음과 같이 검사기를 호출하십시오.
java -cp ~/vnu.jar nu.validator.servlet.Main 8888
vnu-runtime-image/bin/java nu.validator.servlet.Main 8888
vnu-runtime-imagebinjava.exe nu.validator.servlet.Main 8888
그런 다음 브라우저에서 http://0.0.0.0:8888을 엽니다. (다른 포트에서 수신 대기하려면 8888
포트 번호로 바꾸십시오.)
경고: 향후 검사기 릴리스는 기본적으로 주소 127.0.0.1
에 바인딩됩니다. nu.validator.servlet.bind-address
시스템 속성을 사용하여 검사기를 다른 주소에 바인딩하지 않으면 검사기 배포에 접근할 수 없게 될 수 있습니다.
java -cp ~/vnu.jar
-Dnu.validator.servlet.bind-address=128.30.52.73
nu.validator.servlet.Main 8888
vnu-runtime-image/bin/java
-Dnu.validator.servlet.bind-address=128.30.52.73
nu.validator.servlet.Main 8888
vnu-runtime-imagebinjava.exe
-Dnu.validator.servlet.bind-address=128.30.52.73
nu.validator.servlet.Main 8888
http://0.0.0.0:8888(또는 사용 중인 nu.validator.servlet.bind-address
값에 해당하는 URL)을 열면 validator.w3.org/nu와 유사한 양식이 표시됩니다. HTML 문서, CSS 스타일시트 또는 SVG 이미지의 URL을 입력하고 해당 리소스를 확인한 결과를 브라우저에 표시할 수 있습니다.
참고: 검사기를 사용할 때 StackOverflowError
오류가 발생하는 경우 java에 -Xss
옵션을 제공하여 스레드 스택 크기를 조정해 보세요.
java -Xss512k -cp ~/vnu.jar nu.validator.servlet.Main 8888
vnu-runtime-image/bin/java -Xss512k -m vnu/nu.validator.servlet.Main 8888
Apache Tomcat과 같은 기존 서블릿 컨테이너 내에서 검사기를 실행하려면 설명서에 따라 vnu.war
파일을 해당 서버에 배포해야 합니다. 예를 들어, Apache Tomcat에서는 Manager 애플리케이션을 사용하거나 파일을 webapps
디렉터리(기본 appBase
설정이므로)에 복사하여 이 작업을 수행할 수 있습니다. 일반적으로 catalina.out
로그 파일에 다음과 유사한 메시지가 표시됩니다.
May 7, 2014 4:42:04 PM org.apache.catalina.startup.HostConfig deployWAR
INFO: Deploying web application archive /var/lib/tomcat7/webapps/vnu.war
서블릿 컨테이너가 포트 80
에서 localhost
로 전송된 HTTP 요청을 수신하도록 구성되어 있고 이 애플리케이션의 컨텍스트 루트가 vnu
라고 가정하면(종종 기본 동작은 명시적으로 지정하지 않는 한 WAR 파일의 파일 이름을 컨텍스트 루트로 사용하는 것입니다) http://localhost/vnu/에 연결하여 애플리케이션에 액세스할 수 있습니다.
참고: WAR 파일 내의 /WEB-INF/web.xml
파일을 사용자 정의하여(ZIP 처리 프로그램을 사용할 수 있음) 서블릿 필터 구성을 수정할 수 있습니다. 예를 들어 inbound-size-limit 필터를 비활성화하려면 다음과 같이 해당 필터를 주석 처리하면 됩니다.
<!--
<filter>
<filter-name>inbound-size-limit-filter</filter-name>
<filter-class>nu.validator.servlet.InboundSizeLimitFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>inbound-size-limit-filter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
-->
검사기는 명령줄에서 문서를 로컬에서 실행되는 검사기 HTTP 서비스 인스턴스(빠른 명령줄 확인을 위해)로 보내거나 웹상의 원격 인스턴스로 보내는 데 사용할 수 있는 HTTP 클라이언트와 함께 패키지되어 있습니다.
패키지된 HTTP 클라이언트를 사용하여 로컬에서 문서를 확인하려면 다음을 수행하십시오.
독립형 웹 서버 섹션에 설명된 대로 검사기를 로컬 HTTP 서비스로 시작합니다.
새 터미널 창을 열고 다음과 같이 HTTP 클라이언트를 호출합니다.
java -cp ~/vnu.jar nu.validator.client.HttpClient FILE.html...
vnu-runtime-image/bin/java nu.validator.client.HttpClient FILE.html...
html5.validator.nu/와 같은 웹의 검사기 인스턴스로 문서를 보내려면 다음과 같이 nu.validator.client.host 및 nu.validator.client.port 옵션을 사용하십시오.
java -cp ~/vnu.jar -Dnu.validator.client.port=80
-Dnu.validator.client.host=html5.validator.nu
nu.validator.client.HttpClient FILE.html...
...또는 다음과 같습니다:
vnu-runtime-image/bin/java -Dnu.validator.client.port=80
-Dnu.validator.client.host=html5.validator.nu
nu.validator.client.HttpClient FILE.html...
다른 옵션은 아래에 설명되어 있습니다.
검사를 위해 검사기 HTTP 서비스의 인스턴스로 문서를 보내기 위해 패키지된 HTTP 클라이언트를 사용하는 경우 Java 시스템 속성을 설정하여 검사기 동작에 대한 구성 옵션을 제어할 수 있습니다.
예를 들어 다음과 같이 nu.validator.client.level
시스템 속성 값을 error
로 설정하여 경고 수준 메시지를 표시하지 않고 오류 수준 메시지만 표시할 수 있습니다.
java -Dnu.validator.client.level=error
-cp ~/vnu.jar nu.validator.client.HttpClient FILE.html...
...또는 다음과 같습니다:
vnu-runtime-image/bin/java -Dnu.validator.client.level=error
-cp ~/vnu.jar nu.validator.client.HttpClient FILE.html...
아래 나열된 대부분의 속성은 github.com/validator/validator/wiki/Service-»-Common-params에 설명된 대로 검사기 서비스의 공통 입력 매개변수에 매핑됩니다.
Specifies the hostname of the checker for the client to connect to.
default: "127.0.0.1"
Specifies the hostname of the checker for the client to connect to.
default: "8888"
example: java -Dnu.validator.client.port=8080 -jar ~/vnu.jar FILE.html
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: java -Dnu.validator.client.level=error -jar ~/vnu.jar FILE.html
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
Specifies the encoding of the input document.
default: [unset]
Specifies the content-type of the input document.
default: "text/html"; or, for *.xhtml files, "application/xhtml+xml"
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
Specifies whether ASCII quotation marks are substituted for Unicode smart
quotation marks in messages.
default: "yes"
possible values: "yes" or "no"
Binds the validator service to the specified IP address.
default: 0.0.0.0 [causes the checker to listen on all interfaces]
possible values: The IP address of any network interface
example: -Dnu.validator.servlet.bind-address=127.0.0.1
Specifies the connection timeout.
default: 5000
possible values: number of milliseconds
example: -Dnu.validator.servlet.connection-timeout=5000
Specifies the socket timeout.
default: 5000
possible values: number of milliseconds
example: -Dnu.validator.servlet.socket-timeout=5000
GitHub 컨테이너 레지스트리의 https://ghcr.io/validator/validator에서 검사기 Docker 이미지를 가져올 수 있습니다.
최신 버전의 검사기를 가져와 실행하려면 다음을 수행하세요.
docker run -it --rm -p 8888:8888 ghcr.io/validator/validator:latest
컨테이너 레지스트리에서 검사기의 특정 태그/버전(예: 17.11.1
버전)을 가져와 실행하려면 다음을 수행합니다.
docker run -it --rm -p 8888:8888 ghcr.io/validator/validator:17.11.1
검사기를 특정 주소에 바인딩하려면(모든 인터페이스를 수신하지 않고):
docker run -it --rm -p 128.30.52.73:8888:8888
ghcr.io/validator/validator:latest
기본 5초와 다른 연결 시간 제한 및 소켓 시간 제한으로 검사기를 실행하려면 CONNECTION_TIMEOUT_SECONDS
및 SOCKET_TIMEOUT_SECONDS
환경 변수를 사용하세요.
docker run -it --rm
-e CONNECTION_TIMEOUT_SECONDS=15
-e SOCKET_TIMEOUT_SECONDS=15
-p 8888:8888
validator/validator
특정 Java 시스템 속성 집합을 사용하여 검사기를 실행하려면 JAVA_TOOL_OPTIONS
환경 변수를 사용하세요.
docker run -it --rm
-e JAVA_TOOL_OPTIONS=-Dnu.validator.client.asciiquotes=yes
-p 8888:8888
validator/validator
docker compose
와 함께 사용할 vnu
라는 서비스를 정의하려면 다음과 같은 콘텐츠가 포함된 docker-compose.yml
이라는 Compose 파일을 만듭니다(예:).
version: '2' services:
vnu:
image: validator/validator ports:
- "8888:8888"
network_mode: "host" #so "localhost" refers to the host machine.
아래 단계에 따라 검사기 웹 UI를 사용하기 위해 웹 브라우저에서 http://0.0.0.0:8888/
열 수 있도록 검사기를 빌드, 테스트 및 실행하십시오.
git, python, JDK 8 이상이 설치되어 있는지 확인하세요.
JAVA_HOME
환경 변수를 설정합니다.
내보내기 JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64 <-- 우분투 등
내보내기 JAVA_HOME=$(/usr/libexec/java_home) <-- MacOS
작업 디렉터리를 만듭니다.
자식 클론 https://github.com/validator/validator.git
작업 디렉터리로 변경합니다.
CD 유효성 검사기
검사기 Python 스크립트를 시작합니다.
파이썬 ./checker.py 모두
Checker Python 스크립트를 처음 실행하는 경우 온라인 상태여야 하며 빌드에서 몇 메가바이트의 종속성을 다운로드하는 데 시간이 필요합니다.
위 단계에서는 검사기 웹 UI를 사용하기 위해 웹 브라우저에서 http://0.0.0.0:8888/
열 수 있도록 검사기를 빌드, 테스트 및 실행합니다.
경고: 향후 검사기 릴리스는 기본적으로 주소 127.0.0.1
에 바인딩됩니다. --bind-address
옵션을 사용하여 검사기를 다른 주소에 바인딩하지 않으면 검사기 배포에 도달하지 못할 수 있습니다.
python ./checker.py --bind-address=128.30.52.73 all
python ./checker.py --help
사용하여 스크립트 동작을 제어하기 위한 명령줄 옵션과 별도로 호출할 수 있는 빌드 대상 이름을 확인하세요. 예:
python ./checker.py build # 빌드 전용
python ./checker.py build test # 빌드 및 테스트용
python ./checker.py run # 실행만 가능
python ./checker.py jar # vnu.jar 컴파일
python ./checker.py 업데이트-얕은 &&
python ./checker.py dldeps &&
python ./checker.py jar # vnu.jar을 더 빠르게 컴파일하려면