HTML validation, made easy. This repository is the HTML Proofer Ruby gem wrapped up in a Docker container, so you don't have to fuss with installing things like Ruby or Nokogiri.

Requires Docker.

docker run 18fgsa/html-proofer

This will print out the usage instructions. Arguments for the htmlproofer CLI can then be appended to the command. Note that it's not (yet) recommended this be used against live sites due to this issue.

e.g. those created by a static site builder like Jekyll or Hugo. You will need to mount the directory as a data volume so it's available in the container, like so:

docker run -v /absolute/path/to/site/:/mounted-site 18fgsa/html-proofer /mounted-site

You can also mount a single file, like so:

docker run -v /absolute/path/to/file.html:/mounted-file.html 18fgsa/html-proofer /mounted-file.html

You can use this image in GitLab CI, just configure job in .gitlab-ci.yml like this:

test:
  image: 18fgsa/html-proofer:gitlab-ci
  script:
    - htmlproofer _site --empty-alt-ignore