Microformats test suite
This group of tests was built to test microformats parsers. The individual tests are files containing fragments of HTML. There is also a second a corresponding JSON file, which contains the expected output.
The tests are broken into sets within the tests directory of this project. They are first grouped by version. Some parsers only support a single version of microformats. They are then subdivided by the type of microformat i.e. h-card.
To add the latest microformats test suite to your project using npm, run the following command:
npm install microformats/tests --save-dev
Update to the latest microformats test suite with the following command:
npm update microformats/tests
Contributing new tests or updating tests
This set of test belongs to the microformats community. If you find any errors in the current test or new patterns you believe should be in the test suite please feel free to send a pull request.
Notes on creating a new test
A test is built in two parts a HTML file, which contains a fragment of HTML to parse, and JSON file with the expected output from a parser.
Within the “test” directory of this project select the correct directory for the version of microformats the test belongs to. If you are creating a test for a new microformats feature or exploring an issue please add these tests to the “experimental” directory.
Within the correct directory add your new test to subdirecory with either the name of it format i.e.
h-cardor the name of the new feature.
Create the HTML file. Add the smallest and clearest example of the markup you can. There is no need to add head or body tags etc.
Create a JSON file with the same name as your HTML file. The JSON should be the expected output from a parser.
Once you have created the test please update the change-log.html Add a
h-entrywith details of the test . At the bottom of the page please add yourself as a contributor on the authors list
Date format for testing purposes
Within the tests datetime formats are based on the HTML5 profile which is a subset of ISO8601 and allows a space to separate the date and time. To allow us to compare dates please provide a way for your parser to output dates/times with the follwing rules:
- Date and time are separated by a spaces ie
- Date and time keeps the authored level of specificity ie
15:34does NOT become
- Times and timezones always use the
- If used the zulu is always uppercase ie
Microformats test suite is dedicated to the public domain using Creative Commons -- CC0 1.0 Universal.