1
1
mirror of https://github.com/theoludwig/html-w3c-validator.git synced 2024-12-08 00:45:37 +01:00
CLI for validating multiple html pages using validator.w3.org. https://www.npmjs.com/package/html-w3c-validator
Go to file
2023-04-02 21:27:42 +02:00
.github build(deps): update latest 2023-04-02 21:27:42 +02:00
.vscode fix: only consider errors (excluding warning/info messages) 2022-10-20 23:30:41 +02:00
example build(deps): update latest 2023-04-02 21:27:42 +02:00
src fix: update dependencies to latest 2023-01-10 22:15:14 +01:00
.commitlintrc.json chore: initial commit 2022-01-06 19:52:25 +01:00
.editorconfig chore: initial commit 2022-01-06 19:52:25 +01:00
.eslintrc.json feat: usage of ESM modules imports (instead of CommonJS) 2022-04-06 19:59:31 +02:00
.gitattributes chore: maintenance 2022-02-19 16:55:36 +01:00
.gitignore feat: usage of ESM modules imports (instead of CommonJS) 2022-04-06 19:59:31 +02:00
.lintstagedrc.json feat: usage of ESM modules imports (instead of CommonJS) 2022-04-06 19:59:31 +02:00
.markdownlint-cli2.jsonc fix: update dependencies to latest 2023-01-10 22:15:14 +01:00
.markdownlint.json fix: update dependencies to latest 2023-01-10 22:15:14 +01:00
.npmrc chore: maintenance 2022-02-19 16:55:36 +01:00
.prettierrc.json chore: initial commit 2022-01-06 19:52:25 +01:00
.releaserc.json feat: add html-w3c-validator command 2022-01-06 22:34:58 +01:00
.swcrc feat: usage of ESM modules imports (instead of CommonJS) 2022-04-06 19:59:31 +02:00
.taprc feat: usage of ESM modules imports (instead of CommonJS) 2022-04-06 19:59:31 +02:00
CODE_OF_CONDUCT.md chore: initial commit 2022-01-06 19:52:25 +01:00
CONTRIBUTING.md chore: initial commit 2022-01-06 19:52:25 +01:00
LICENSE chore: initial commit 2022-01-06 19:52:25 +01:00
package-lock.json build(deps): update latest 2023-04-02 21:27:42 +02:00
package.json build(deps): update latest 2023-04-02 21:27:42 +02:00
README.md fix: only consider errors (excluding warning/info messages) 2022-10-20 23:30:41 +02:00
tsconfig.json fix: update dependencies to latest 2023-01-10 22:15:14 +01:00

html-w3c-validator

CLI for validating multiple html pages using validator.w3.org.

Licence MIT Contributor Covenant

Conventional Commits semantic-release npm version

📜 About

html-w3c-validator is a CLI tool to validate multiple html pages using validator.w3.org.

You might use a JavaScript framework or simply use HTML but you should always validate your production HTML and this validation should be part of your CI/CD pipeline (tests, linting, etc.).

Why should I validate my HTML pages?

Quote from https://validator.w3.org/docs/help.html#why-validate:

One of the important maxims of computer programming is: "Be conservative in what you produce; be liberal in what you accept."

Browsers follow the second half of this maxim by accepting Web pages and trying to display them even if they're not legal HTML. Usually this means that the browser will try to make educated guesses about what you probably meant. The problem is that different browsers (or even different versions of the same browser) will make different guesses about the same illegal construct; worse, if your HTML is really pathological, the browser could get hopelessly confused and produce a mangled mess, or even crash.

⚙️ Getting Started

You can combine html-w3c-validator with start-server-and-test to validate HTML pages of your project.

Prerequisites

Installation (with start-server-and-test)

npm install --save-dev html-w3c-validator start-server-and-test

⚙️ Configuration

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

{
  "urls": ["http://127.0.0.1:3000/", "http://127.0.0.1:3000/about"],

  // You can also specify HTML files instead of URLs
  "files": ["./index.html", "./about.html"]
}

Usage

npm run test:html-w3c-validator

Example of output (in case of success):

✔ Validating http://127.0.0.1:3000/
✔ Validating http://127.0.0.1:3000/about

Success: HTML validation (W3C) passed! 🎉

See the ./example folder for practical usage.

Options

-V, --version       Output the version number.
-h, --help          Display help for command.

💡 Contributing

Anyone can help to improve the project, submit a Feature Request, a bug report or even correct a simple spelling mistake.

The steps to contribute can be found in the CONTRIBUTING.md file.

📄 License

MIT