A user account is required in order to edit this wiki, but we've had to disable public user registrations due to spam.

To request an account, ask an autoconfirmed user on IRC (such as one of these permanent autoconfirmed members).

Anolis

From WHATWG Wiki
Revision as of 18:37, 25 April 2013 by Tantek (talk | contribs) (add troubleshooting section with actual problems/errors encountered and solutions that worked)
Jump to: navigation, search

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

Setting up 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:

  •  ??? TBD