= Paragraphs
:doctitle:    Paragraphs
:description: http://asciidoc.org/userguide.html#_paragraphs
include::attributes.asciidoc[]
:navinfo2:


== Admonition paragraphs

[role="lead"]
'TIP', 'NOTE', 'IMPORTANT', 'WARNING' and 'CAUTION' admonishment
paragraph styles are generated by placing `NOTE:`, `TIP:`,
`IMPORTANT:`, `WARNING:` or `CAUTION:` as the first word of the
paragraph.

Since version 1.2.0, admonitionblock used _alert-block_ Twitter Bootstrap styles.
With support of icons font, it's now time to change the behavior and default styles.

To compare three render categories, we will use the same file source
footnote:[{rawbaseurl}/docs/admonition-samples.asciidoc].

=== Using text captions

By default the AsciiDoc HTML backends generate text captions instead of admonition icon image links.

ifdef::basebackend-docbook[]
See xref:_admonition_paragraphs_using_text[]
endif::basebackend-docbook[]
ifdef::basebackend-html[]
link:admonition-text.html[See]
endif::basebackend-html[]
what it look like without images or icons font symbols.

=== Using images

By default the AsciiDoc HTML backends generate text captions instead of admonition icon image links.
To generate links to icon images define the `icons` attribute,
for example using the +-a icons+ command-line option.

As AsciiDoc, this backend will have the same default behavior.

ifdef::basebackend-docbook[]
See xref:_admonition_paragraphs_using_icons_images[]
endif::basebackend-docbook[]
ifdef::basebackend-html[]
link:admonition-images.html[See]
endif::basebackend-html[]
what it look like.

=== Using icons font

Since version 3.1.0, admonitionblock may optionally used icons font to draw icons.
To generate links to icons font symbols define the `iconsfont` attribute.

Remember that you can use any of icons font support by the backend.

* http://glyphicons.com/[Glyphicons] - use +-a iconsfont=glyphicon+
* http://fontawesome.io[Font-Awesome] - use +-a iconsfont=font-awesome+
* http://ionicons.com/[Ionicons] - use +-a iconsfont=ionicons+
* https://octicons.github.com/[Octicons] - use +-a iconsfont=octicons+

ifdef::basebackend-docbook[]
See xref:_admonition_paragraphs_using_icons_font[]
endif::basebackend-docbook[]
ifdef::basebackend-html[]
link:admonition-iconsfont.html[See]
endif::basebackend-html[]
what it look like with Font-Awesome.
