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 Chat (such as one of these permanent autoconfirmed members).

Anolis: Difference between revisions

From WHATWG Wiki
Jump to navigation Jump to search
(→‎Setting up ms2ger/anolis: cssselect is also required.)
(add troubleshooting section with actual problems/errors encountered and solutions that worked)
Line 21: Line 21:
  hg clone https://code.google.com/p/html5lib
  hg clone https://code.google.com/p/html5lib
  cd html5lib/python && sudo python setup.py install
  cd html5lib/python && sudo python setup.py install
== Troubleshooting ==
=== No targets specified ===
If you try to "make" and get a message like:<pre>make: *** No targets specified and no makefile found.  Stop.</pre>
Then you're likely trying to do a <kbd>make</kbd> in the wrong directory.
Solution:
# Change your current directory to the parent of the item you're trying to make,
# Verify that there is a "Makefile" in that directory,
# Try again
=== No rule to make xref ===
If you try to "make" and get a message like:<pre>make: *** No rule to make target `../xref', needed by `Overview.html'.  Stop.</pre>
Then you're likely missing the "xref" repository.
Solution:
# Clone the "xref" repository into a directory that is a sibling of the directory you're working in.
# Try again
=== No such option xref ===
If you try to "make" and get a message like:<pre>anolis: error: no such option: --xref</pre>
Then your Anolis is likely out of date.
Solution:
# Update your Anolis respository
# Update your install of the "anolis" tool, e.g. in "/usr/local/bin/anolis"
# Try again
=== No module named lxml ===
If you try to "make" and get a message like:<pre>ImportError: No module named lxml</pre>
Then you're missing the lxml library.
Solution:
* ??? TBD


[[Category:Spec coordination]]
[[Category:Spec coordination]]

Revision as of 18:37, 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:

  • ??? TBD