CINXE.COM

<!DOCTYPE html> <html class="client-nojs" lang="en" dir="ltr"> <head> <meta charset="UTF-8"/> <title>Anolis - WHATWG Wiki</title> <script>document.documentElement.className="client-js";RLCONF={"wgBreakFrames":false,"wgSeparatorTransformTable":["",""],"wgDigitTransformTable":["",""],"wgDefaultDateFormat":"dmy","wgMonthNames":["","January","February","March","April","May","June","July","August","September","October","November","December"],"wgRequestId":"f54130e0e96b450a01d48638","wgCSPNonce":false,"wgCanonicalNamespace":"","wgCanonicalSpecialPageName":false,"wgNamespaceNumber":0,"wgPageName":"Anolis","wgTitle":"Anolis","wgCurRevisionId":10042,"wgRevisionId":10042,"wgArticleId":1976,"wgIsArticle":true,"wgIsRedirect":false,"wgAction":"view","wgUserName":null,"wgUserGroups":["*"],"wgCategories":["Spec coordination"],"wgPageContentLanguage":"en","wgPageContentModel":"wikitext","wgRelevantPageName":"Anolis","wgRelevantArticleId":1976,"wgIsProbablyEditable":false,"wgRelevantPageIsProbablyEditable":false,"wgRestrictionEdit":[],"wgRestrictionMove":[],"wgVector2022PreviewPages":[]};RLSTATE={"ext.gadget.WatchlistChangesBold":"ready" ,"ext.gadget.widensearch":"ready","site.styles":"ready","user.styles":"ready","user":"ready","user.options":"loading","skins.vector.styles.legacy":"ready"};RLPAGEMODULES=["site","mediawiki.page.ready","mediawiki.toc","skins.vector.legacy.js","ext.gadget.exlinks","ext.gadget.charinsert","ext.gadget.edittop","ext.gadget.PrettyLog"];</script> <script>(RLQ=window.RLQ||[]).push(function(){mw.loader.implement("user.options@12s5i",function($,jQuery,require,module){mw.user.tokens.set({"patrolToken":"+\\","watchToken":"+\\","csrfToken":"+\\"});});});</script> <link rel="stylesheet" href="/load.php?lang=en&modules=skins.vector.styles.legacy&only=styles&skin=vector"/> <script async="" src="/load.php?lang=en&modules=startup&only=scripts&raw=1&skin=vector"></script> <meta name="ResourceLoaderDynamicStyles" content=""/> <link rel="stylesheet" href="/load.php?lang=en&modules=ext.gadget.WatchlistChangesBold%2Cwidensearch&only=styles&skin=vector"/> <link rel="stylesheet" href="/load.php?lang=en&modules=site.styles&only=styles&skin=vector"/> <meta name="generator" content="MediaWiki 1.39.3"/> <meta name="format-detection" content="telephone=no"/> <meta name="viewport" content="width=1000"/> <link rel="apple-touch-icon" href="https://resources.whatwg.org/logo.png"/> <link rel="icon" href="https://resources.whatwg.org/logo.svg"/> <link rel="search" type="application/opensearchdescription+xml" href="/opensearch_desc.php" title="WHATWG Wiki (en)"/> <link rel="EditURI" type="application/rsd+xml" href="https://wiki.whatwg.org/api.php?action=rsd"/> <link rel="license" href="/wiki/WHATWG_Wiki:Copyrights"/> <link rel="alternate" type="application/atom+xml" title="WHATWG Wiki Atom feed" href="/index.php?title=Special:RecentChanges&feed=atom"/> </head> <body class="mediawiki ltr sitedir-ltr mw-hide-empty-elt ns-0 ns-subject page-Anolis rootpage-Anolis skin-vector action-view skin-vector-legacy vector-feature-language-in-header-enabled vector-feature-language-in-main-page-header-disabled vector-feature-language-alert-in-sidebar-disabled vector-feature-sticky-header-disabled vector-feature-sticky-header-edit-disabled vector-feature-table-of-contents-disabled vector-feature-visual-enhancement-next-disabled"><div id="mw-page-base" class="noprint"></div> <div id="mw-head-base" class="noprint"></div> <div id="content" class="mw-body" role="main"> <a id="top"></a> <div id="siteNotice"><div id="localNotice"><div class="anonnotice" lang="en" dir="ltr"><div id="anonNotice"> <div style="margin: 0.5em auto; border: 1px solid #333333; background-color: #EEEEEE; padding: 0.5em; font-size: larger; text-align: center;"> <p>A user account is required in order to edit this wiki, but we've had to disable public user registrations due to spam. </p><p>To request an account, ask an autoconfirmed user on <a rel="nofollow" class="external text" href="https://whatwg.org/chat">Chat</a> (such as one of <span class="plainlinks"><a rel="nofollow" class="external text" href="https://wiki.whatwg.org/index.php?title=Special:ListUsers&group=autoconfirmed">these permanent autoconfirmed members</a></span>). </p> </div> </div></div></div></div> <div class="mw-indicators"> </div> <h1 id="firstHeading" class="firstHeading mw-first-heading"><span class="mw-page-title-main">Anolis</span></h1> <div id="bodyContent" class="vector-body"> <div id="siteSub" class="noprint">From WHATWG Wiki</div> <div id="contentSub"></div> <div id="contentSub2"></div> <div id="jump-to-nav"></div> <a class="mw-jump-link" href="#mw-head">Jump to navigation</a> <a class="mw-jump-link" href="#searchInput">Jump to search</a> <div id="mw-content-text" class="mw-body-content mw-content-ltr" lang="en" dir="ltr"><div class="mw-parser-output"><p><b>Anolis is no longer maintained. Please use <a rel="nofollow" class="external text" href="https://github.com/tabatkins/bikeshed/">bikeshed</a> instead.</b> </p><p>Anolis is a tool to generate specification-like documents out of simple HTML. </p> <ul><li><a rel="nofollow" class="external free" href="http://pimpmyspec.net/">http://pimpmyspec.net/</a></li> <li><a rel="nofollow" class="external free" href="http://hg.hoppipolla.co.uk/">http://hg.hoppipolla.co.uk/</a> -- jgraham's work</li> <li><a rel="nofollow" class="external free" href="http://bitbucket.org/ms2ger/anolis">http://bitbucket.org/ms2ger/anolis</a> -- used by most WHATWG standards, the latest version</li></ul> <div id="toc" class="toc" role="navigation" aria-labelledby="mw-toc-heading"><input type="checkbox" role="button" id="toctogglecheckbox" class="toctogglecheckbox" style="display:none" /><div class="toctitle" lang="en" dir="ltr"><h2 id="mw-toc-heading">Contents</h2><span class="toctogglespan"><label class="toctogglelabel" for="toctogglecheckbox"></label></span></div> <ul> <li class="toclevel-1 tocsection-1"><a href="#Setting_up_ms2ger/anolis"><span class="tocnumber">1</span> <span class="toctext">Setting up ms2ger/anolis</span></a></li> <li class="toclevel-1 tocsection-2"><a href="#Troubleshooting"><span class="tocnumber">2</span> <span class="toctext">Troubleshooting</span></a> <ul> <li class="toclevel-2 tocsection-3"><a href="#No_targets_specified"><span class="tocnumber">2.1</span> <span class="toctext">No targets specified</span></a></li> <li class="toclevel-2 tocsection-4"><a href="#No_rule_to_make_xref"><span class="tocnumber">2.2</span> <span class="toctext">No rule to make xref</span></a></li> <li class="toclevel-2 tocsection-5"><a href="#No_such_option_xref"><span class="tocnumber">2.3</span> <span class="toctext">No such option xref</span></a></li> <li class="toclevel-2 tocsection-6"><a href="#No_module_named_lxml"><span class="tocnumber">2.4</span> <span class="toctext">No module named lxml</span></a></li> <li class="toclevel-2 tocsection-7"><a href="#Connection_reset_by_peer"><span class="tocnumber">2.5</span> <span class="toctext">Connection reset by peer</span></a></li> <li class="toclevel-2 tocsection-8"><a href="#TypeError_Item_in_from_list_not_a_string"><span class="tocnumber">2.6</span> <span class="toctext">TypeError Item in from list not a string</span></a></li> </ul> </li> </ul> </div> <h2><span id="Setting_up_ms2ger.2Fanolis"></span><span class="mw-headline" id="Setting_up_ms2ger/anolis">Setting up ms2ger/anolis</span></h2> <ul><li>Install <a rel="nofollow" class="external free" href="http://bitbucket.org/ms2ger/anolis">http://bitbucket.org/ms2ger/anolis</a>:</li></ul> <pre>hg clone <a rel="nofollow" class="external free" href="http://bitbucket.org/ms2ger/anolis">http://bitbucket.org/ms2ger/anolis</a> cd anolis && sudo python setup.py install </pre> <ul><li>install lxml using whatever package manager is appropriate for your OS/environment; for example, one of the following:</li></ul> <pre>sudo easy_install lxml sudo port install py27-lxml sudo apt-get install python-lxml brew install libxml </pre> <ul><li>install cssselect using whatever package manager is appropriate for your OS/environment; for example, one of the following:</li></ul> <pre>sudo easy_install cssselect sudo port install py27-cssselect sudo apt-get install python-cssselect </pre> <ul><li>install html5lib:</li></ul> <pre>sudo easy_install html5lib </pre> <h2><span class="mw-headline" id="Troubleshooting">Troubleshooting</span></h2> <h3><span class="mw-headline" id="No_targets_specified">No targets specified</span></h3><p> If you try to "make" and get a message like:</p><pre>make: *** No targets specified and no makefile found. Stop.</pre> <p>Then you're likely trying to do a <kbd>make</kbd> in the wrong directory. </p><p>Solution: </p> <ol><li>Change your current directory to the parent of the item you're trying to make,</li> <li>Verify that there is a "Makefile" in that directory,</li> <li>Try again</li></ol> <h3><span class="mw-headline" id="No_rule_to_make_xref">No rule to make xref</span></h3><p> If you try to "make" and get a message like:</p><pre>make: *** No rule to make target `../xref', needed by `Overview.html'. Stop.</pre> <p>Then you're likely missing the "xref" repository. </p><p>Solution: </p> <ol><li>Clone the "xref" repository into a directory that is a sibling of the directory you're working in.</li> <li>Try again</li></ol> <h3><span class="mw-headline" id="No_such_option_xref">No such option xref</span></h3><p> If you try to "make" and get a message like:</p><pre>anolis: error: no such option: --xref</pre> <p>Then your Anolis is likely out of date. </p><p>Solution: </p> <ol><li>Update your Anolis respository</li> <li>Update your install of the "anolis" tool, e.g. in "/usr/local/bin/anolis"</li> <li>Try again</li></ol> <h3><span class="mw-headline" id="No_module_named_lxml">No module named lxml</span></h3><p> If you try to "make" and get a message like:</p><pre>ImportError: No module named lxml</pre> <p>Then you're missing the lxml library. </p><p>Solution: </p> <ol><li>Install lxml per the above instructions, e.g. <kbd><pre> sudo easy_install lxml</pre></kbd></li> <li>Try again</li></ol> <h3><span class="mw-headline" id="Connection_reset_by_peer">Connection reset by peer</span></h3> <p>If you're trying to install lxml and get an error message like: </p> <pre>Downloading http://lxml.de/files/lxml-3.1.2.tgz error: Connection reset by peer</pre> <p>Then the network you're on may be problematic. </p><p>Solution: </p> <ol><li>Switch to a different network (e.g. a mifi)</li> <li>Try again</li></ol> <h3><span class="mw-headline" id="TypeError_Item_in_from_list_not_a_string">TypeError Item in from list not a string</span></h3> <p>If you try to "make" and get messages like: </p> <pre>Traceback (most recent call last): File "/usr/local/bin/anolis", line 325, in <module> main() File "/usr/local/bin/anolis", line 69, in main tree = generator.fromFile(input, **kwargs) File "/Library/Python/2.7/site-packages/anolislib/generator.py", line 90, in fromFile process(tree, processes, **kwargs) File "/Library/Python/2.7/site-packages/anolislib/generator.py", line 38, in process locals(), [process], -1), TypeError: Item in ``from list'' not a string make: *** [Overview.html] Error 1 </pre> <p>Then ... (no idea) </p><p>Solution: </p> <ul><li>TBD</li></ul> <p>Workaround: </p> <ol><li>Give up on locally installed Anolis</li> <li>Commit your Overview.src.html as is, noting in the commit message that the Overview.html was not updated</li> <li>Use the <a rel="nofollow" class="external free" href="http://anolis.hoppipolla.co.uk/aquarium.py">http://anolis.hoppipolla.co.uk/aquarium.py</a> web service</li> <li>Submit the raw.github.com "raw file" URL of the Overview.src.html you just committed</li> <li>Save the result over the Overview.html in the same directory as the Overview.src.html</li> <li>Commit it with message "sync with Overview.src.html - used anolis.hoppipolla.co.uk/aquarium.py"</li></ol>    </div> <div class="printfooter" data-nosnippet="">Retrieved from "<a dir="ltr" href="https://wiki.whatwg.org/index.php?title=Anolis&oldid=10042">https://wiki.whatwg.org/index.php?title=Anolis&oldid=10042</a>"</div></div> <div id="catlinks" class="catlinks" data-mw="interface"><div id="mw-normal-catlinks" class="mw-normal-catlinks"><a href="/wiki/Special:Categories" title="Special:Categories">Category</a>: <ul><li><a href="/wiki/Category:Spec_coordination" title="Category:Spec coordination">Spec coordination</a></li></ul></div></div> </div> </div> <div id="mw-navigation"> <h2>Navigation menu</h2> <div id="mw-head"> <nav id="p-personal" class="vector-menu mw-portlet mw-portlet-personal vector-user-menu-legacy" aria-labelledby="p-personal-label" role="navigation" > <h3 id="p-personal-label" class="vector-menu-heading " > <span class="vector-menu-heading-label">Personal tools</span> </h3> <div class="vector-menu-content"> <ul class="vector-menu-content-list"><li id="pt-login" class="mw-list-item"><a href="/index.php?title=Special:UserLogin&returnto=Anolis" title="You are encouraged to log in; however, it is not mandatory [o]" accesskey="o"><span>Log in</span></a></li></ul> </div> </nav> <div id="left-navigation"> <nav id="p-namespaces" class="vector-menu mw-portlet mw-portlet-namespaces vector-menu-tabs vector-menu-tabs-legacy" aria-labelledby="p-namespaces-label" role="navigation" > <h3 id="p-namespaces-label" class="vector-menu-heading " > <span class="vector-menu-heading-label">Namespaces</span> </h3> <div class="vector-menu-content"> <ul class="vector-menu-content-list"><li id="ca-nstab-main" class="selected mw-list-item"><a href="/wiki/Anolis" title="View the content page [c]" accesskey="c"><span>Page</span></a></li><li id="ca-talk" class="new mw-list-item"><a href="/index.php?title=Talk:Anolis&action=edit&redlink=1" rel="discussion" title="Discussion about the content page (page does not exist) [t]" accesskey="t"><span>Discussion</span></a></li></ul> </div> </nav> <nav id="p-variants" class="vector-menu mw-portlet mw-portlet-variants emptyPortlet vector-menu-dropdown" aria-labelledby="p-variants-label" role="navigation" > <input type="checkbox" id="p-variants-checkbox" role="button" aria-haspopup="true" data-event-name="ui.dropdown-p-variants" class="vector-menu-checkbox" aria-labelledby="p-variants-label" /> <label id="p-variants-label" aria-label="Change language variant" class="vector-menu-heading " > <span class="vector-menu-heading-label">English</span> </label> <div class="vector-menu-content"> <ul class="vector-menu-content-list"></ul> </div> </nav> </div> <div id="right-navigation"> <nav id="p-views" class="vector-menu mw-portlet mw-portlet-views vector-menu-tabs vector-menu-tabs-legacy" aria-labelledby="p-views-label" role="navigation" > <h3 id="p-views-label" class="vector-menu-heading " > <span class="vector-menu-heading-label">Views</span> </h3> <div class="vector-menu-content"> <ul class="vector-menu-content-list"><li id="ca-view" class="selected mw-list-item"><a href="/wiki/Anolis"><span>Read</span></a></li><li id="ca-viewsource" class="mw-list-item"><a href="/index.php?title=Anolis&action=edit" title="This page is protected.
You can view its source [e]" accesskey="e"><span>View source</span></a></li><li id="ca-history" class="mw-list-item"><a href="/index.php?title=Anolis&action=history" title="Past revisions of this page [h]" accesskey="h"><span>View history</span></a></li></ul> </div> </nav> <nav id="p-cactions" class="vector-menu mw-portlet mw-portlet-cactions emptyPortlet vector-menu-dropdown" aria-labelledby="p-cactions-label" role="navigation" title="More options" > <input type="checkbox" id="p-cactions-checkbox" role="button" aria-haspopup="true" data-event-name="ui.dropdown-p-cactions" class="vector-menu-checkbox" aria-labelledby="p-cactions-label" /> <label id="p-cactions-label" class="vector-menu-heading " > <span class="vector-menu-heading-label">More</span> </label> <div class="vector-menu-content"> <ul class="vector-menu-content-list"></ul> </div> </nav> <div id="p-search" role="search" class="vector-search-box-vue vector-search-box-show-thumbnail vector-search-box-auto-expand-width vector-search-box"> <div> <h3 > <label for="searchInput">Search</label> </h3> <form action="/index.php" id="searchform" class="vector-search-box-form"> <div id="simpleSearch" class="vector-search-box-inner" data-search-loc="header-navigation"> <input class="vector-search-box-input" type="search" name="search" placeholder="Search WHATWG Wiki" aria-label="Search WHATWG Wiki" autocapitalize="sentences" title="Search WHATWG Wiki [f]" accesskey="f" id="searchInput" > <input type="hidden" name="title" value="Special:Search"> <input id="mw-searchButton" class="searchButton mw-fallbackSearchButton" type="submit" name="fulltext" title="Search the pages for this text" value="Search"> <input id="searchButton" class="searchButton" type="submit" name="go" title="Go to a page with this exact name if it exists" value="Go"> </div> </form> </div> </div> </div> </div> <div id="mw-panel"> <div id="p-logo" role="banner"> <a class="mw-wiki-logo" href="/" title="Visit the main page"></a> </div> <nav id="p-navigation" class="vector-menu mw-portlet mw-portlet-navigation vector-menu-portal portal" aria-labelledby="p-navigation-label" role="navigation" > <h3 id="p-navigation-label" class="vector-menu-heading " > <span class="vector-menu-heading-label">Navigation</span> </h3> <div class="vector-menu-content"> <ul class="vector-menu-content-list"><li id="n-mainpage" class="mw-list-item"><a href="/" title="Visit the main page [z]" accesskey="z"><span>Main Page</span></a></li><li id="n-randompage" class="mw-list-item"><a href="/wiki/Special:Random" title="Load a random page [x]" accesskey="x"><span>Random page</span></a></li><li id="n-recentchanges" class="mw-list-item"><a href="/wiki/Special:RecentChanges" title="A list of recent changes in the wiki [r]" accesskey="r"><span>Recent changes</span></a></li></ul> </div> </nav> <nav id="p-WHATWG" class="vector-menu mw-portlet mw-portlet-WHATWG vector-menu-portal portal" aria-labelledby="p-WHATWG-label" role="navigation" > <h3 id="p-WHATWG-label" class="vector-menu-heading " > <span class="vector-menu-heading-label">WHATWG</span> </h3> <div class="vector-menu-content"> <ul class="vector-menu-content-list"><li id="n-Standards" class="mw-list-item"><a href="https://spec.whatwg.org/" rel="nofollow"><span>Standards</span></a></li><li id="n-FAQ" class="mw-list-item"><a href="https://whatwg.org/faq" rel="nofollow"><span>FAQ</span></a></li><li id="n-Chat" class="mw-list-item"><a href="https://whatwg.org/chat" rel="nofollow"><span>Chat</span></a></li><li id="n-Code-of-Conduct" class="mw-list-item"><a href="https://whatwg.org/code-of-conduct" rel="nofollow"><span>Code of Conduct</span></a></li><li id="n-GitHub" class="mw-list-item"><a href="https://github.com/whatwg" rel="nofollow"><span>GitHub</span></a></li><li id="n-What-you-can-do" class="mw-list-item"><a href="/wiki/What_you_can_do"><span>What you can do</span></a></li><li id="n-To-do-list" class="mw-list-item"><a href="/wiki/Specs_todo"><span>To-do list</span></a></li></ul> </div> </nav> <nav id="p-Registries" class="vector-menu mw-portlet mw-portlet-Registries vector-menu-portal portal" aria-labelledby="p-Registries-label" role="navigation" > <h3 id="p-Registries-label" class="vector-menu-heading " > <span class="vector-menu-heading-label">Registries</span> </h3> <div class="vector-menu-content"> <ul class="vector-menu-content-list"><li id="n-<meta-name>" class="mw-list-item"><a href="/wiki/MetaExtensions"><span><meta name></span></a></li><li id="n-rel=""" class="mw-list-item"><a href="http://microformats.org/wiki/existing-rel-values" rel="nofollow"><span>rel=""</span></a></li></ul> </div> </nav> <nav id="p-tb" class="vector-menu mw-portlet mw-portlet-tb vector-menu-portal portal" aria-labelledby="p-tb-label" role="navigation" > <h3 id="p-tb-label" class="vector-menu-heading " > <span class="vector-menu-heading-label">Tools</span> </h3> <div class="vector-menu-content"> <ul class="vector-menu-content-list"><li id="t-whatlinkshere" class="mw-list-item"><a href="/wiki/Special:WhatLinksHere/Anolis" title="A list of all wiki pages that link here [j]" accesskey="j"><span>What links here</span></a></li><li id="t-recentchangeslinked" class="mw-list-item"><a href="/wiki/Special:RecentChangesLinked/Anolis" rel="nofollow" title="Recent changes in pages linked from this page [k]" accesskey="k"><span>Related changes</span></a></li><li id="t-specialpages" class="mw-list-item"><a href="/wiki/Special:SpecialPages" title="A list of all special pages [q]" accesskey="q"><span>Special pages</span></a></li><li id="t-print" class="mw-list-item"><a href="javascript:print();" rel="alternate" title="Printable version of this page [p]" accesskey="p"><span>Printable version</span></a></li><li id="t-permalink" class="mw-list-item"><a href="/index.php?title=Anolis&oldid=10042" title="Permanent link to this revision of this page"><span>Permanent link</span></a></li><li id="t-info" class="mw-list-item"><a href="/index.php?title=Anolis&action=info" title="More information about this page"><span>Page information</span></a></li></ul> </div> </nav> </div> </div> <footer id="footer" class="mw-footer" role="contentinfo" > <ul id="footer-info"> <li id="footer-info-lastmod"> This page was last edited on 25 February 2016, at 09:51.</li> <li id="footer-info-copyright">Content is available under <a href="/wiki/WHATWG_Wiki:Copyrights" title="WHATWG Wiki:Copyrights">a CC0 Universal Public Domain Declaration, with some restrictions</a> unless otherwise noted.</li> </ul> <ul id="footer-places"> <li id="footer-places-about"><a href="/wiki/WHATWG_Wiki:About">About WHATWG Wiki</a></li> </ul> <ul id="footer-icons" class="noprint"> <li id="footer-poweredbyico"><a href="https://www.mediawiki.org/"><img src="/resources/assets/poweredby_mediawiki_88x31.png" alt="Powered by MediaWiki" srcset="/resources/assets/poweredby_mediawiki_132x47.png 1.5x, /resources/assets/poweredby_mediawiki_176x62.png 2x" width="88" height="31" loading="lazy"/></a></li> </ul> </footer> <script>(RLQ=window.RLQ||[]).push(function(){mw.config.set({"wgPageParseReport":{"limitreport":{"cputime":"0.000","walltime":"0.007","ppvisitednodes":{"value":57,"limit":1000000},"postexpandincludesize":{"value":0,"limit":2097152},"templateargumentsize":{"value":0,"limit":2097152},"expansiondepth":{"value":2,"limit":100},"expensivefunctioncount":{"value":0,"limit":100},"unstrip-depth":{"value":0,"limit":20},"unstrip-size":{"value":913,"limit":5000000},"timingprofile":["100.00% 0.000 1 -total"]},"cachereport":{"timestamp":"20250204224448","ttl":86400,"transientcontent":false}}});mw.config.set({"wgBackendResponseTime":286});});</script> </body>  </html>