<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<meta name="generator" content="AsciiDoc 8.3.1" />
<link rel="stylesheet" href="./xhtml11.css" type="text/css" />
<link rel="stylesheet" href="./xhtml11-quirks.css" type="text/css" />
<link rel="stylesheet" href="./layout1.css" type="text/css" />
<title>AsciiDoc Version 9</title>
</head>
<body>
<div id="layout-banner">
<div id="layout-title">AsciiDoc</div>
<div id="layout-description">Text based document generation</div>
</div>
<table>
<tr valign="top">
<td id="layout-menu">
<div>»<a href="index.html">Home</a></div>
<div>»<a href="manpage.html">Man Page</a></div>
<div>»<a href="userguide.html">User Guide</a></div>
<div>»<a href="http://powerman.name/doc/asciidoc">Cheatsheet</a></div>
<div>»<a href="a2x.1.html">a2x</a></div>
<div>»<a href="README.html">README</a></div>
<div>»<a href="CHANGELOG.html">ChangeLog</a></div>
<div>»<a href="INSTALL.html">Installation</a></div>
<div>»<a href="downloads.html">Downloads</a></div>
<div>»<a href="faq.html">FAQ</a></div>
<div>»<a href="support.html">Support</a></div>
<div id="page-source">»<a href="version9.txt">Page Source</a></div>
</td>
<td>
<div id="layout-content">
<div id="header">
<h1>AsciiDoc Version 9</h1>
</div>
<div id="preamble">
<div class="sectionbody">
<div class="paragraph"><p>Installing and configuring the latest version of <em>AsciiDoc</em> across
various distributions and platforms has never been easy and lots of
contributors have put in <a href="downloads.html#X1">lots of effort</a> to do
just this — this never ending and largely thankless task is the bane
of the Open Source developer and user alike because invevitably
distribution specific packages are either missing or are soon out of
date.</p></div>
<div class="paragraph"><p>But it doesn’t have to be like this — <em>AsciiDoc</em> is a pure Python
application and could be distributed from the
<a href="http://pypi.python.org/">Cheese Shop</a> as a stand-alone platform
independent <a href="http://peak.telecommunity.com/DevCenter/PythonEggs">Python
Egg</a>. The 9.x branch aims to attack this problem.</p></div>
<div class="paragraph"><p>The feature plan for 9.0 is:</p></div>
<div class="ulist"><ul>
<li>
<p>
<em>AsciiDoc</em> easy_installable (done, not fully tested).
</p>
</li>
<li>
<p>
<em>AsciiDoc</em> as a Python module with a decent API (now a module, no API
yet).
</p>
</li>
<li>
<p>
<em>AsciiDoc</em> 100% Python: no shell or unportable scripting (not done).
</p>
</li>
</ul></div>
<div class="paragraph"><p>Later in the 9.x branch:</p></div>
<div class="ulist"><ul>
<li>
<p>
plugin system for frontend and backends.
</p>
</li>
<li>
<p>
plugin system for style-sheets.
</p>
</li>
<li>
<p>
distutils commands to produce <em>AsciiDoc</em> rendered documentation of
Python packages (minimal support now in buildutils).
</p>
</li>
</ul></div>
<div class="paragraph"><p><a href="http://ygingras.net">Yannick Gingras</a> is the maintainer of the 9.x branch;
he can be contacted by <a href="mailto:ygingras@ygingras.net">email</a> or, preferably,
on the <a href="support.html">mailing list</a>.</p></div>
<div class="paragraph"><p>There is no release of the 9.x branch yet but adventurous users can
still get the source with Mercurial:</p></div>
<div class="literalblock">
<div class="content">
<pre><tt>hg clone static-http://ygingras.net/files/asciidoc.hg asciidoc-9x</tt></pre>
</div></div>
<div class="paragraph"><p>Using sources from the Mercurial repository will require
<a href="http://peak.telecommunity.com/DevCenter/setuptools">Setuptools</a> and the
<a href="http://pypi.python.org/pypi/hg.setuptools/">Mercurial plugin</a> for
Setuptools.</p></div>
<div class="admonitionblock">
<table><tr>
<td class="icon">
<img src="./images/icons/note.png" alt="Note" />
</td>
<td class="content">The 9.x branch is still experimental. You should install it
inside a <a href="http://pypi.python.org/pypi/virtualenv/">virtualenv</a> to
prevent damages to your global Python environment.</td>
</tr></table>
</div>
</div>
</div>
<div id="footer">
<div id="footer-text">
Version 8.3.1<br />
Last updated 2008-12-13 10:00:00 NZDT
</div>
<div id="footer-badges">
<a href="http://validator.w3.org/check?uri=referer">
<img style="border:none; width:88px; height:31px;"
src="http://www.w3.org/Icons/valid-xhtml11"
alt="Valid XHTML 1.1!" />
</a>
<a href="http://jigsaw.w3.org/css-validator/check/referer">
<img style="border:none; width:88px; height:31px;"
src="http://jigsaw.w3.org/css-validator/images/vcss"
alt="Valid CSS!" />
</a>
<a href="http://www.mozilla.org/products/firefox/">
<img style="border:none; width:110px; height:32px;"
src="http://www.spreadfirefox.com/community/images/affiliates/Buttons/110x32/safer.gif"
alt="Get Firefox!" />
</a>
</div>
</div>
</div>
</td>
</tr>
</table>
</body>
</html>