skip to navigation
skip to content

html5validator 0.1.14

Validate HTML5 files.

This was written with static site generators like Jekyll and Pelican in mind that push to a static server. html5validator is a command line executable that integrates well with CircleCI and TravisCI and tests all static html files for HTML5 validity.


Install with pip install html5validator and run with

html5validator --root _build/ --ignore "Attribute “ng-[a-z-]+” not allowed"

to validate all html files in the _build directory and to ignore all messages that match the regular expression Attribute “ng-[a-z-]+” not allowed.

This package uses the backend which is written in Java. Therefore, a Java Runtime Environment must be available on your system.

Integration with CircleCI

Create a circle.yml file:

    - sudo pip install html5validator
    - html5validator

in your repository with static html files and get HTML5 validation on every git push.

Integration with TravisCI

Create a .travis.yml file:

language: python
    - gh-pages
 - "2.7"
 - "pip install html5validator"
script: "html5validator"

Enable the repository on TravisCI.

You probably don’t want TravisCI to run on the master branch but only on the gh-pages branch. TravisCI has an option (off by default) to run tests only on branches that have a .travis.yml.

You can also use this for user pages (repositories of the form <username> where the html files are in the master branch. You only have to remove:

    - gh-pages

from .travis.yml. I am using this on my own user page.

Technical Notes

  • If you are using grunt already, maybe consider using the grunt-html plugin for grunt instead.
  • Use --ignore "Attribute “ng-[a-z-]+” not allowed" with angular.js apps.
  • Example with multiple ignores: html5validator --root tests/multiple_ignores/ --ignore "Attribute “ng-[a-z-]+” not allowed" "Start tag seen without seeing a doctype first"
  • Be careful with the non-standard quotes in the error messages when constructing the expressions to ignore.


  • master

  • 0.1.12 (2015-05-07)
    • document how to specify multiple regular expressions to be ignored
    • add --ignore as command line argument. Takes a regular expression for warnings and errors that should be ignored.
  • 0.1.9 (2015-03-02)

File Type Py Version Uploaded on Size
html5validator-0.1.14.tar.gz (md5) Source 2015-10-09 21MB
  • Downloads (All Versions):
  • 71 downloads in the last day
  • 390 downloads in the last week
  • 1733 downloads in the last month