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.

*Fedora Linux*::
  mailto:terje.rosten@ntnu.no[Terje Rosten] has created an RPM
  package for Fedora Linux which can be downloaded from
  http://www.pvv.ntnu.no/~terjeros/rpms/asciidoc/[].
  Terje has made the RPM spec file and source RPM available so you can
  rebuild the RPM for non-Fedora RPM based distros.

*Slackware Linux*::
  John Calixto has created a Slackware package for AsciiDoc which can
  be downloaded from http://linuxpackages.net/[].

*Ark Linux*::
  mailto:bero@arklinux.org[Bernhard Rosenkraenzer] added AsciiDoc to
  Ark Linux -- the package is available from the Ark Linux repository
  at http://arklinux.osuosl.org/dockyard-devel/[], so Ark Linux users
  should just run `apt-get install asciidoc`.

*T2 Linux*::
  mailto:cw@ixplanet.de[Christian Wiese] added AsciiDoc to the
  http://www.t2-project.org/[T2 Linux] repository at
  http://svn.exactcode.de/t2/trunk/package/textproc/asciidoc/[]. To
  build and install the package on a T2 system, run
  `./scripts/Emerge-Pkg asciidoc` from within your T2 source directory
  (default: `/usr/src/t2-src`).

See also link:userguide.html#X38[Packager Notes] in the 'AsciiDoc User
Guide'.

[[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-{revision}.zip` ZIP archive if you're
installing on Microsoft Windows, the `asciidoc-{revision}.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-{revision}.tar.gz` tarball but
there are a number of duplicated files (in lieu of symbolic links).

link:asciidoc-{revision}.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:

[subs="normal"]
  $ tar -xzf asciidoc-{revision}.tar.gz
  $ cd asciidoc-{revision}
  $ less README
--

link:asciidoc-{revision}.zip[]::
  A Zip distribution of the latest version of AsciiDoc for Microsoft
  Windows users (UNIX users should use the tarball since includes
  symbolic links to eliminate file duplication).
+
--  
To install the zip formatted distribution just unzip the contents to a
new folder and read the link:README.html[README] file:

[subs="normal"]
  $ mkdir asciidoc
  $ cd asciidoc
  $ unzip ../asciidoc-{revision}.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).
