This repository contains the tools and instructions necessary for building the HTML Standard from its source.
Before building, make sure you have the following commands installed on your system.
curl,git,grep,perl,unzip
Optionally, for faster builds, you can install Wattsi on your system. If you don't bother with that, the build will use Wattsi Server.
Building your own copy of the HTML Standard from its source requires just these simple steps:
- If you want to submit a pull request to the whatwg/html repo, fork it and clone your fork. (If not, you can skip this step.)
git clone https://github.com/<username>/html.git
- Clone this (html-build) repo:
git clone https://github.com/whatwg/html-build.git && cd html-build
- Run the
build.shscript from inside yourhtml-buildworking directory, like this:
./build.sh
After you complete the build steps above, the build will run and generate the single-page version of the spec, the multipage version, and more. If all goes well, you should very soon have all the following in your output/ directory:
.htaccess404.htmlentities.jsonfonts/*images/*indexlink-fixup.jsmultipage/*
And then you're also ready to edit the html/source file—and after you make your changes, you can run the build.sh script again to see the new output.
Your clone doesn't need the HTML standard's complete revision history just for you to build the spec and contribute patches. So, by default we don't start you out with a clone of the history. That makes your first build finish much faster. And if later you decide you do want to clone the complete history, you can still get it, by doing this:
cd ./html && git fetch --unshallow
That said, if you really do want to start out with the complete history of the repo, then run the build script for the first time like this:
HTML_GIT_CLONE_OPTIONS="" ./build.sh
That will clone the complete history for you. But be warned: It'll make your first build take dramatically longer to finish!