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).

Difference between revisions of "Anolis"

From WHATWG Wiki
Jump to: navigation, search
(add troubleshooting section with actual problems/errors encountered and solutions that worked)
(more troubleshooting: No module named lxml, Connection reset by peer)
Line 55: Line 55:
  
 
Solution:
 
Solution:
* ??? TBD
+
# Install lxml per the above instructions, e.g. <kbd><pre> sudo easy_install lxml</pre></kbd>
 +
# Try again
 +
 
 +
=== Connection reset by peer ===
 +
If you're trying to install lxml and get an error message like:
 +
<pre>Downloading http://lxml.de/files/lxml-3.1.2.tgz
 +
error: Connection reset by peer</pre>
 +
Then the network you're on may be problematic.
 +
 
 +
Solution:
 +
# Switch to a different network (e.g. a mifi)
 +
# Try again
  
 
[[Category:Spec coordination]]
 
[[Category:Spec coordination]]

Revision as of 19:02, 25 April 2013

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:

  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