AsciiDoc
Text based document generation
»Home
»Man Page
»User Guide
»a2x
»README
»ChangeLog
»Downloads
»Support
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 platform specific packages or the latest platform agnostic distribution archives.

Prepackaged Versions

The following platform specific packages are available:

Debian GNU/Linux

If you use Debian or a Debian based distribution there's an AsciiDoc Debian package available. Thanks to Fredrik Steen who built and maintains the Debian AsciiDoc package.

Gentoo Linux

If you use Gentoo Linux there's a Gentoo AsciiDoc package available. Thanks to Brandon Philips for writing the ebuild.

Fedora Linux

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

See also Packager Notes in the AsciiDoc User Guide.

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

A tarball distribution of the latest version of AsciiDoc.

To install the tarball distribution extract the tarball and read the README file:

$ tar -xzf asciidoc-7.1.0.tar.gz
$ cd asciidoc-7.1.0
$ less README
asciidoc-7.1.0.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 README file:

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

Copying

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