<commit_before>= {title}
:title:       Paragraphs
:description: http://asciidoc.org/userguide.html#_paragraphs
include::attributes.asciidoc[]
:navinfo2:
:icons!:
:iconsfont:   font-awesome
:jumbotron:
:footer!:


== 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.

Want to link:admonition-text.default.html[see] what it look like without images or icons font symbols.
Start with Bootstrap *Default* theme.

[TIP]
=====================================================================
.Use later the Themes menu to switch skin and compare render

* standard *AsciiDoc* html5 backend
* Bootstrap *Default* theme
* Bootswatch *Flatly* theme
* Bootswatch *Readable* theme
=====================================================================

=== 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.

Want to link:admonition-images.default.html[see] what it look like with Bootstrap *Default* theme.

[TIP]
=====================================================================
.Use later the Themes menu to switch skin and compare render

* standard *AsciiDoc* html5 backend
* Bootstrap *Default* theme
* Bootswatch *Flatly* theme
* Bootswatch *Readable* theme
=====================================================================


=== 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+

Want to link:admonition-iconsfont.default.html[see] what it look like with Font-Awesome.
Start with Bootstrap *Default* theme.

[TIP]
=====================================================================
.Use later the Themes menu to switch skin and compare render

* standard *AsciiDoc* html5 backend
* Bootstrap *Default* theme
* Bootswatch *Flatly* theme
* Bootswatch *Readable* theme
=====================================================================

footnote:[{rawbaseurl}/docs/paragraphs.asciidoc].
<commit_msg>remove tip about theme render comparaison (will not be available in stable release 4.0)<commit_after>= {title}
:title:       Paragraphs
:description: http://asciidoc.org/userguide.html#_paragraphs
include::attributes.asciidoc[]
:navinfo2:
:icons!:
:iconsfont:   font-awesome
:jumbotron:
:footer!:


== 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.

Want to link:admonition-text.default.html[see] what it look like without images or icons font symbols.
Start with Bootstrap *Default* theme.

=== 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.

Want to link:admonition-images.default.html[see] what it look like with Bootstrap *Default* theme.

=== 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+

Want to link:admonition-iconsfont.default.html[see] what it look like with Font-Awesome.
Start with Bootstrap *Default* theme.

footnote:[{rawbaseurl}/docs/paragraphs.asciidoc].

{'fraction_non_alphanumeric': 0.16640986132511557, 'fraction_numerical': 0.0036594761171032356, 'mean_word_length': 5.507518796992481, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '4376073', 'n_tokens_mistral': 1531, 'n_tokens_neox': 1430, 'n_words': 562}