validator.w3.org를 사용하여 HTML 페이지의 유효성을 검사하기 위한 CLI입니다.
html-w3c-validator 는 validator.w3.org를 사용하여 HTML 페이지의 유효성을 검사하는 CLI 도구입니다.
JavaScript 프레임워크를 사용하거나 단순히 HTML을 사용할 수 있지만 항상 프로덕션 HTML의 유효성을 검사해야 하며 이 유효성 검사는 CI/CD 파이프라인(테스트, Linting 등)의 일부여야 합니다.
https://validator.w3.org/docs/help.html#why-validate에서 인용:
컴퓨터 프로그래밍의 중요한 격언 중 하나는 "당신이 생산하는 것에 있어서는 보수적이 되고, 받아들이는 것에 있어서는 진보적이 되십시오."입니다.
브라우저는 웹 페이지를 허용하고 합법적인 HTML이 아니더라도 표시하려고 시도함으로써 이 격언의 두 번째 절반을 따릅니다. 일반적으로 이는 브라우저가 사용자가 의도한 내용에 대해 정보를 바탕으로 추측을 시도한다는 것을 의미합니다. 문제는 서로 다른 브라우저(또는 동일한 브라우저의 서로 다른 버전)가 동일한 불법 구조에 대해 서로 다른 추측을 한다는 것입니다. 더 나쁜 것은 HTML이 정말 병적이라면 브라우저는 절망적으로 혼란스러워지고 혼란스러워지거나 심지어 충돌할 수도 있습니다.
html-w3c-validator를 start-server-and-test와 결합하여 프로젝트의 HTML 페이지를 검증할 수 있습니다.
Node.js >= 16.0.0
npm install --save-dev html-w3c-validator start-server-and-test
package.json
{
"scripts" : {
// Command to start the server serving your HTML pages (e.g: using vercel/serve)
"start" : "serve "./build"" ,
// Command to validate your HTML pages
"test:html-w3c-validator" : "start-server-and-test "start" "http://127.0.0.1:3000" "html-w3c-validator"" ,
} ,
}
.html-w3c-validatorrc.json
{
"$schema" : "./node_modules/html-w3c-validator/schema/schema.json" ,
// URLs to validate.
"urls" : [ "http://127.0.0.1:3000/" , "http://127.0.0.1:3000/about" ] ,
// Files to validate.
"files" : [ "./index.html" , "./about.html" ] ,
// Specify the severities of the validator messages to report. (default: ["warning", "error"])
"severities" : [ "info" , "warning" , "error" ] ,
}
node --run test:html-w3c-validator
출력 예(성공한 경우):
✔ Validating http://127.0.0.1:3000/
✔ Validating http://127.0.0.1:3000/about
Success: HTML validation (W3C) passed! ?
실제 사용법은 ./example 폴더를 참조하세요.
--current-working-directory <path> The current working directory (default: `process.cwd()`).
-V, --version Output the version number.
-h, --help Display help for command.
누구나 프로젝트 개선에 도움을 주고, 기능 요청, 버그 보고서를 제출하거나 심지어 간단한 철자 오류를 수정할 수도 있습니다.
기여 단계는 CONTRIBUTING.md 파일에서 찾을 수 있습니다.
MIT