Download and Install AsciiDoc
=============================

NOTE: The current version of AsciiDoc requires *Python 2.3 or newer*
to run.  If you don't already have an up-to-date version of Python
installed it can be downloaded from the official Python website
http://www.python.org/[].

You can install AsciiDoc from <<X1,platform specific packages>> or
the latest <<X2,platform agnostic distribution archives>>.


[[X1]]
Prepackaged Versions
--------------------
The following platform specific packages are available:

*Debian GNU/Linux*::
  If you use Debian or a Debian based distribution there's an
  http://packages.debian.org/asciidoc[AsciiDoc Debian package]
  available.  Thanks to mailto:stone@debian.org[Fredrik Steen] who
  built and maintains the Debian AsciiDoc package.

*Gentoo Linux*::
  If you use Gentoo Linux there's a
  http://packages.gentoo.org/packages/?category=app-text;name=asciidoc[Gentoo
  AsciiDoc package] available. Thanks to
  mailto:brandon@ifup.org[Brandon Philips] for writing the ebuild.


[[X2]]
Distribution Archives
---------------------
You can also install AsciiDoc from the following platform agnostic
distribution archives (also available, along with previous AsciiDoc
versions, at the SourceForge
http://sourceforge.net/projects/asciidoc/[]):

IMPORTANT: Use the `asciidoc-7.0.0.zip` ZIP archive if you're
installing on Microsoft Windows, the `asciidoc-7.0.0.tar.gz` tarball
contains symbolic links and is for installation on UNIX platforms
(Microsoft Windows does not support symbolic links). The ZIP archive
contains the same files as the `asciidoc-7.0.0.tar.gz` tarball but
there are a number of duplicated files (in lieu of symbolic links).

link:asciidoc-7.0.0.tar.gz[]::
  A tarball distribution of the latest version of AsciiDoc.
+
--
To install the tarball distribution extract the tarball and read the
link:README.html[README] file:

  $ tar -xzf asciidoc-7.0.0.tar.gz
  $ cd asciidoc-7.0.0
  $ less README
--

link:asciidoc-7.0.0.zip[]::
  A Zip distribution of the latest version of AsciiDoc.
+
--  
To install the zip formatted distribution just unzip the contents to a
new folder and read the link:README.html[README] file:

  $ mkdir asciidoc
  $ cd asciidoc
  $ unzip ../asciidoc-7.0.0.zip
  $ less README
--

Copying
-------
Copyright (C) 2002-2005 Stuart Rackham. Free use of AsciiDoc is
granted under the terms of the GNU General Public License (GPL).
