This repository contains all the tools that are being used to publish the following specifications of the HTML WG:
- HTML
- Canvas
- Microdata
Support for further specifications may be added as things progress.
Just check it out wherever seems convenient to you, and it should work. Its one dependency is a recent version of Anolis.
There is a default-config.json
file included here. Do NOT edit it, it
is just the default. If you need to override its values, create a local-config.json
file and use it to override just the values you need. For instance, if you
need your HTML draft to be in /some/other/path
(the default assumes ../html
), just
create this local-config.json
:
{
"html": { "path": "/some/other/path" }
}
You can run this either as:
python publish.py [html|2dcontext|microdata]
or as:
make [html|2dcontext|microdata]
The make
variant runs exactly the same thing, but checks to see if the source has changed
since the last generation. This can be faster if you're working on the spec, but be warned
that it does not check if other dependencies may have changed too (e.g. the boilerplate)
and so can trip you.
- make output directory configurable
- add support for generating against a specific branch, or multiple branches
- add a linter