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

See the link:README.html[README] and link:INSTALL.html[INSTALL] pages
for install prerequisites and procedures.


[[X2]]
Distribution Archives
---------------------
These distribution archives are also available, along with previous
AsciiDoc versions, at the SourceForge
http://sourceforge.net/projects/asciidoc/.

link:asciidoc-{revision}.tar.gz[]::
  A tarball distribution of the latest version of AsciiDoc for *NIX
  platforms.

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).


[[X3]]
Mercurial Repository
--------------------
The AsciiDoc http://www.selenic.com/mercurial/[Mercurial] repository
is hosted by http://sharesource.org[ShareSource].  ShareSource is a
Mercurial friendly website for hosting Open Source projects.

To browse the repo go to http://hg.sharesource.org/asciidoc/.


[[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*::
  With help from Terje Røsten, Chris Wright added asciidoc to Fedora
  Extras which is available in the default installation. To install
  asciidoc execute the following command:

  $ yum install asciidoc

*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`).

*Red Hat Enterprise Linux, Fedora and CentOS packages*::
  Dag Wieers has built AsciiDoc RPMs for a number of Red Hat based
  distributions, they can be downloaded from
  http://dag.wieers.com/rpm/packages/asciidoc/.

*CSW Package for Sun Solaris*::
  Ben Walton has created a CSW package for AsciiDoc, you can find it
  here: http://opencsw.org/packages/asciidoc.

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

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