CreateNewSpecVersion

From W3C XForms Group Wiki (Public)

You can find all the relevant scripts in our CVS at http://www.w3.org/MarkUp/Forms/specs/WikiTools/Revdoc

Create a directory on your machine with the contents of the above Revdoc directory, and the contained Build directory.

To create the Spec follow these instructions

  • Create the next round page on the wiki by copying the previous one (e.g.: Round 2)
  • Add a ReleaseEvent to the forms.rounds array in the file Revdoc/group_data.py
  • Update xforms.round in Revdoc/build/build.properties
  • Change to the Build directory, and run ant (which by default uses target generate-spec-html from the build file build.xml)
  • the spec is now generated in the Revdoc directory
  • After committing the spec to the correct location you can run Revdoc/check.sh to validate if the spec is ready for publishing.

Prerequisites

You need to locally install ant, python, and pip, as well as HTML Tidy, and hdiff.

You can find the instruction to install pip at http://pip.readthedocs.org/en/latest/installing.html (on Ubuntu just issue 'sudo apt-get install python-pip') HTML Tidy is also in the repositories for Ubuntu. (Not sure yet where to find hdiff)

Additional Modules that need to be installed:

  • html5lib (to install : pip install html5lib)