AsciiDoc is a text document format for writing short documents, articles, books and UNIX man pages.

AsciiDoc is a text document format for writing short documents, articles, books and UNIX man pages.

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.

You write an AsciiDoc document the same way you would write a normal text document, there are no markup tags or weird format notations. AsciiDoc files are designed to be viewed, edited and printed directly or translated to other presentation formats using the asciidoc command.

The asciidoc command translates AsciiDoc files to HTML, XHTML and DocBook markups. DocBook can be post-processed to presentation formats such as HTML, PDF, roff, and Postscript using readily available Open Source tools.

What's New in This Release:

Additions and changes
· Added dvi, ps and tex output format options to a2x(1).
· Added --dblatex option to a2x(1) so dblatex(1) can be used to
generate PDFs.
· Added custom dblatex(1) configuration files (in distribution
./dblatex directory) which are used by a2x(1).
· dblatex(1) is now used to generate the distributed PDF version of
the AsciiDoc User Guide.
· If you don't need a customized the link caption you can enter the
http, https, ftp, file URLs and email addresses without any special
macro syntax -- you get the links by just cutting and pasting URLs
and emails addresses. This also makes it easier to open links
directly form AsciiDoc source ( most editors allow you to open URLs
directly). The Vim syntax highlighter has been updated to reflect
these changes.
· Highlighted source code paragraphs have been implemented -- it's a
much more convenient way to enter short code examples (see [2]the
online docs).
· The source highlighter and music filter syntax has changed -- they
now used the ListingBlock syntax customized with source and music
style attribute values. This follows the Paragraph styling
convention introduced by the source paragraph (previous item) and
is easier to read. The old syntax still works but has been
deprecated.
· QuoteBlocks now have a verse style -- you no longer have to nest a
verse LiteralBlock inside a QuoteBlock for verses. The verse style
on the LiteralBlock has been deprecated (still works though) and
the style attribute is positional attribute 1, pushing attribution
and citetitle attributes to the right (you'll need to insert a
quote attribute into your existing QuoteBlocks).
· It is no up to the DocBook processor to highlight source code
syntax in elements rather than GNU Highlighter --
this is the correct way to handle it, plus dblatex(1) makes a much
better job.
· scaledwidth and align attributes have been added to the image
macro. They apply to DocBook outputs (specifically for PDF
documents). scaledwidth sets the image size as a percent of the
available page width; align applies left, center or right
horizontal image justification.
· Added a2x(1) --fop-opts=FOP_OPTS option (patch submitted by Miklos
Vajna).
· Added a2x(1) --dblatex-opts=DBLATEX_OPTS option.
· Added Mikhail Yakshin's FOP 0.95 patch which fixes a long-standing
fo.xsl problem and allows PDF's to be generated with FOP 0.95
(previously had to use FOP 0.20.5).
· The User Guide has been updated and outdated FOP configuration and
installation sections removed.

Bug fixes
· Fixed stylesheets/xhtml11-manpage.css not being included when
linkcss attribute was used.
· Configuration file *-style attributes are now dumped correctly.
· Fixed FAILED: malformed section entry LaTeX backend error.