AsciiDoc User Guide

•You can produce the older DocBook SGML format using the —attribute=sgml command-line option.

•Use the encoding attribute to set the character set encoding (same as the xhtml11 backend).

•The AsciiDoc Preamble element generates a DocBook book preface element although it's more usual to use an explicit Preface special section (see the ./doc/book.txt example book).

xhtml11

The default asciidoc(1) backend is xhtml11 which generates XHTML 1.1 markup styled with CSS2. Default output file have a .html extension. xhtml11 document generation is influenced by the following attributes (the default behavior is to generate XHTML with no section numbers, embedded CSS and no linked admonition icon images):

numbered

Adds section numbers to section titles.

linkcss

Link CSS stylesheets. By default stylesheets are embedded (linkcss is undefined).

icons

Link admonition paragraph and admonition block icon images and badge images. By default icons is undefined and text is used in place of icon images.

badges

Link badges (XHTML 1.1, CSS and Get Firefox!) in document footers. By default badges are omitted (badges is undefined).

encoding

Set the input and output document character set encoding. For example the —attribute=encoding=ISO-8859-1 command-line option will set the character set encoding to

ISO-8859-1.

•This attribute specifies the character set in the output document.

•The encoding name must correspond to a Python codec name or alias.

•The default encoding is UTF-8.

quirks

Use the xhtml11-quirks.css stylesheet to work around IE6 browser incompatibilities (this is the default behavior).

stylesdir

The name of the directory containing linked stylesheets. Defaults to ., the same directory as the linking document).

scriptsdir

The name of the directory containing linked JavaScripts. Defaults to ., the same directory as the

7