AsciiDoc User Guide

consetetur, eu pro everti postulant homero verear ea mea, qui.

Renders:

Consul *necessitatibus* per id, consetetur, eu pro everti postulant homero verear ea mea, qui.

Admonition Paragraphs

Tip, Note, Important, Warning and Caution paragraph definitions support the corresponding DocBook admonishment elements — just write a normal paragraph but place NOTE:, TIP:, IMPORTANT:, WARNING: or CAUTION: as the first word of the paragraph. For example:

NOTE: This is an example note.

or the alternative syntax:

[NOTE]

This is an example note.

Renders:

Note

This is an example note.

Tip

If your admonition is more than a single paragraph use an admonition block instead.

Admonition Icons and Captions

Note

Admonition customization with icons, iconsdir, icon and caption attributes does not apply when generating DocBook output. If you are going the DocBook route then the a2x(1) —no-icons and —icons-dir options can be used to set the appropriate XSL Stylesheets parameters.

By default the asciidoc(1) xhtml11 and html4 backends generate text captions instead of icon image links. To generate links to icon images define the icons attribute, for example using the -a icons command-line option.

The iconsdir attribute sets the location of linked icon images.

You can override the default icon image using the icon attribute to specify the path of the linked image. For example:

18