Anolis

Anolis is a tool to generate specification-like documents out of simple HTML.

• http://pimpmyspec.net/
• http://hg.hoppipolla.co.uk/ -- jgraham's work
• http://bitbucket.org/ms2ger/anolis -- used by most WHATWG standards, the latest version

Setting up ms2ger/anolis

• Install http://bitbucket.org/ms2ger/anolis:

hg clone http://bitbucket.org/ms2ger/anolis
cd anolis && sudo python setup.py install

• install lxml using whatever package manager is appropriate for your OS/environment; for example, one of the following:

sudo easy_install lxml
sudo port install py27-lxml
sudo apt-get install python-lxml

• install cssselect using whatever package manager is appropriate for your OS/environment; for example, one of the following:

sudo easy_install cssselect
sudo port install py27-cssselect
sudo apt-get install python-cssselect

• install html5lib:

hg clone https://code.google.com/p/html5lib
cd html5lib/python && sudo python setup.py install

Troubleshooting

No targets specified

If you try to "make" and get a message like:

make: *** No targets specified and no makefile found.  Stop.

Then you're likely trying to do a make in the wrong directory.

Solution:

1. Change your current directory to the parent of the item you're trying to make,
2. Verify that there is a "Makefile" in that directory,
3. Try again

No rule to make xref

If you try to "make" and get a message like:

make: *** No rule to make target `../xref', needed by `Overview.html'.  Stop.

Then you're likely missing the "xref" repository.

Solution:

1. Clone the "xref" repository into a directory that is a sibling of the directory you're working in.
2. Try again

No such option xref

If you try to "make" and get a message like:

anolis: error: no such option: --xref

Then your Anolis is likely out of date.

Solution:

1. Update your Anolis respository
2. Update your install of the "anolis" tool, e.g. in "/usr/local/bin/anolis"
3. Try again

No module named lxml

If you try to "make" and get a message like:

ImportError: No module named lxml

Then you're missing the lxml library.

Solution:

1. Install lxml per the above instructions, e.g.

    sudo easy_install lxml

2. Try again

Connection reset by peer

If you're trying to install lxml and get an error message like:

Downloading http://lxml.de/files/lxml-3.1.2.tgz
error: Connection reset by peer

Then the network you're on may be problematic.

Solution:

1. Switch to a different network (e.g. a mifi)
2. Try again