README.asciidoc

Note	This repository (asciidoc-py2) is no longer supported as python 2 has entered end-of-life. Please see asciidoc-py for the currently supported version.

AsciiDoc

AsciiDoc is a text document format for writing notes, documentation, articles, books, ebooks, slideshows, web pages, man pages and blogs. AsciiDoc files can be translated to many formats including HTML, PDF, EPUB, man page.

AsciiDoc is highly configurable: both the AsciiDoc source file syntax and the backend output markups (which can be almost any type of SGML/XML markup) can be customized and extended by the user.

Prerequisites

AsciiDoc is written in Python so you need a Python interpreter (version 2.6 or 2.7) to execute asciidoc(1). Python is installed by default in most Linux distributions. You can download Python from the official Python website http://www.python.org.

Obtaining AsciiDoc

Documentation and installation instructions are on the AsciiDoc website http://asciidoc.org/

Tools

Current AsciiDoc version tested on Xubuntu Linux 10.04 with:

• Python 2.6.5

• DocBook XSL Stylesheets 1.76.1

• xsltproc (libxml 20706, libxslt 10126 and libexslt 815).

• w3m 0.5.2

• dblatex 0.3

• FOP 0.95

• A-A-P 1.091

Copying

Copyright © 2002-2013 Stuart Rackham. Free use of this software is granted under the terms of the GNU General Public License version 2 (GPLv2).