You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
60 lines
1.8 KiB
60 lines
1.8 KiB
4 years ago
|
////
|
||
|
|
Included in:
|
||
|
|
|
||
|
|
- user-manual: Quote
|
||
|
|
////
|
||
|
|
|
||
|
|
// tag::intro[]
|
||
|
|
Prose excerpts, quotes and verses share the same syntax structure, including:
|
||
|
|
|
||
|
|
* block name, either `quote` or `verse`
|
||
|
|
* name of who the content is attributed to
|
||
|
|
* bibliographical information of the book, speech, play, poem, etc., where the content was drawn from
|
||
|
|
* excerpt text
|
||
|
|
// end::intro[]
|
||
|
|
|
||
|
|
// tag::basic[]
|
||
|
|
For content that doesn't require the preservation of line breaks, set the `quote` attribute in the first position of the attribute list.
|
||
|
|
Next, set the attribution and relevant citation information.
|
||
|
|
However, these positional attributes are optional.
|
||
|
|
|
||
|
|
.Anatomy of a basic quote
|
||
|
|
----
|
||
|
|
[quote, attribution, citation title and information]
|
||
|
|
Quote or excerpt text
|
||
|
|
----
|
||
|
|
|
||
|
|
If the quote is a single line or paragraph, you can place the attribute list directly on top of the text.
|
||
|
|
|
||
|
|
.Quote paragraph syntax
|
||
|
|
[source]
|
||
|
|
----
|
||
|
|
include::ex-quote.adoc[tag=para2-c]
|
||
|
|
----
|
||
|
|
<1> Mark lead-in text explaining the context or setting of the quote using a period (`.`). (optional)
|
||
|
|
<2> For content that doesn't require the preservation of line breaks, set `quote` in the first position of the attribute list.
|
||
|
|
<3> The second position contains who the excerpt is attributed to. (optional)
|
||
|
|
<4> Enter additional citation information in the third position. (optional)
|
||
|
|
<5> Enter the excerpt or quote text on the line immediately following the attribute list.
|
||
|
|
|
||
|
|
.Result: Quote paragraph
|
||
|
|
====
|
||
|
|
include::ex-quote.adoc[tag=para2]
|
||
|
|
====
|
||
|
|
|
||
|
|
If the quote or excerpt is more than one paragraph, place the text between delimiter lines consisting of four underscores (`+____+`).
|
||
|
|
|
||
|
|
.Quote block syntax
|
||
|
|
[source]
|
||
|
|
----
|
||
|
|
include::ex-quote.adoc[tag=comp]
|
||
|
|
----
|
||
|
|
|
||
|
|
.Result: Quote block
|
||
|
|
====
|
||
|
|
include::ex-quote.adoc[tag=comp]
|
||
|
|
====
|
||
|
|
|
||
|
|
Asciidoctor also provides three alternative ways to markup quotes and prose excerpts.
|
||
|
|
// end::basic[]
|