Anolis / website / index.html

<!DOCTYPE html><html lang=en-gb-x-sneddy><head><meta charset=utf-8>
<link href=style.css rel=stylesheet>
a:not([href]) {
background-color: #00f;
color: #fff;
span:not([title=""]):not(.secno) {
background-color: #a00;
color: #fff;


<h2 class="no-num no-toc" id=contents>Contents</h2>

<ol class=toc>
 <li><a href=#introduction><span class=secno>1 </span>Introduction</a></li>
 <li><a href=#installing-anolis><span class=secno>2 </span>Installing Anolis</a>
   <li><a href=#requirements><span class=secno>2.1 </span>Requirements</a></li>
   <li><a href=#obtaining-a-copy><span class=secno>2.2 </span>Obtaining a copy</a></li>
   <li><a href=#installation><span class=secno>2.3 </span>Installation</a></li>
   <li><a href=#running-the-test-suite><span class=secno>2.4 </span>Running the test suite</a></li></ol></li>
 <li><a href=#documentation><span class=secno>3 </span>Documentation</a></li>
 <li><a class=no-num href=#acknowledgements>Acknowledgements</a></li></ol>

<h2 id=introduction><span class=secno>1 </span>Introduction</h2>

<p>The need for Anolis came from the need for long technical documents to
include niceties such as cross-references and a table of contents for the
purpose of easy navigation — doing this manually can be a great chore
especially when sections are numbered and a section is added, consequently
changing the numbering of many others, leading to it being advantageous to do it

<p>Anolis does this on HTML documents, as a number of sequential processes.
Currently cross-referencing, section numbering, table of contents creation, and
a number of substitutions are done (mainly relating to the current

<h2 id=installing-anolis><span class=secno>2 </span>Installing Anolis</h2>

<h3 id=requirements><span class=secno>2.1 </span>Requirements</h3>

<p>The following are the minimum requirements: later versions should also work
without issue.</p>

	<li><a href=>Python</a> 2.6
	</li><li><a href=>lxml</a> 2.0
	</li><li><a href=>html5lib</a> 0.10

<h3 id=obtaining-a-copy><span class=secno>2.2 </span>Obtaining a copy</h3>

<p>The latest release is 1.2. This can downloaded as a
<a href=>bzip2</a>,
<a href=>zip</a>, or
<a href=>gzip</a>

<p>Alternatively, a copy can be obtained from <dfn id=our-mercurial-repository>our <a href=>Mercurial</a> repository</dfn>: this is
where our ongoing development occurs, and allows any revision (and therefore any
release) to be downloaded. Our repository is located at
<code><!--begin-link--><a href=></a><!--end-link--></code>.

</p><h3 id=installation><span class=secno>2.3 </span>Installation</h3>

<p>Normally, installation is done through <a href=>setuptools</a>, with the following

<p><code>python install</code></p>

<p>Please see setuptools' documentation for information on installation options
(such as installing in non-standard locations).</p>

<h3 id=running-the-test-suite><span class=secno>2.4 </span>Running the test suite</h3>

<p>The source distribution and the current development copy (in <a href=#our-mercurial-repository title="our
mercurial repository">Mercurial</a>) both contain a test suite. It can be run
with the following command:</p>


<p>Any test failures should be reported at our
<dfn id=bug-tracker><a href=>bug

<h2 id=documentation><span class=secno>3 </span>Documentation</h2>

<p>Documentation is included with the latest release, and the documentation for
the latest release can be obtained <a href=>here</a>.</p>

<h2 class=no-num id=acknowledgements>Acknowledgements</h2>

<p>Thanks to Andrew Sidwell, Anne van Kesteren, Henri Sivonen, Ian Hickson,
James Graham, Lachlan Hunt, Magnus Kristiansen, Michael(tm) Smith, and Philip
Taylor for their ever needed help.</p>

<p>Special thanks to Geoffrey Sneddon, who created this tool.</p>

<p>Special thanks to Bert Bos for creating the CSS3 Module Postprocessor, on
which this is partially based, and (with <code>--w3c-compat</code>) claims to be
partially compatible with. Further special thanks to Bert Bos for creating a
number of things (especially the algorithm for finding the W3C status) that took
the author of Anolis many hours to reverse engineer.</p>