abstract-block.adoc 944 Bytes
Newer Older
1
2
// REVIEW we may want to rethink where this page is located
= Abstract (Block)
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37

An abstract is a concise overview of a document.
The `abstract` block style can be placed on an open block or paragraph.
Here's an example of the abstract block style set on a paragraph:

[source]
----
= Document Title

[abstract]
.Abstract
Documentation is a distillation of many long adventures.

== First Section
----

The abstract block style does not require the open block or paragraph to have a title, and it does not depend on a subsequent section to terminate it.

[source]
----
= Document Title

[abstract]
--
This article will take you on a wonderful adventure of knowledge.

You'll start with the basics.
Beyond that, where you go is up to you.
--

Your journey begins here.
----

TIP: To include a quote at the beginning of a chapter in a book, wrap a quote block inside an abstract block.

Dan Allen's avatar
Dan Allen committed
38
There's also an xref:abstract.adoc[abstract section style].