散文摘录、引用和诗句共享相同的语法结构,包括:

  • 区块名称,可以是 quote 或者 `verse

  • 内容归因于谁的名字

  • 书籍、演讲、戏剧、诗歌等内容来源的参考文献信息

  • 选段文本

基本引用语法

对于不需要保留换行符的内容,请将`quote`属性设置在属性列表的第一个位置。接下来,设置归因和相关的引证信息。这些位置属性都是可选的。

基本报价的解剖
[引用,署名,引用标题和信息]
引用或摘录文本

你可以在分隔每个位置属性的逗号后包含一个可选的空格。如果属性值包含逗号,请将该值用双引号或单引号括起来。

如果引用是单行或者段落(即,一个有样式的段落),你可以直接将属性列表放置在文本上方。

引用段落的语法
Unresolved directive in blockquotes.adoc - include::example$quote.adoc[tag=para2-c]
  1. 使用句点(.)作为标记的引导文本,解释引用的上下文或设置。(可选)

  2. 对于不需要保留换行符的内容,请在属性列表的第一个位置设置`quote`。

  3. 第二个位置包含节选内容的归属者。(可选)

  4. 在第三个位置输入额外的引用信息。(可选)

  5. 将摘录或引用文本输入紧跟在属性列表之后的那一行。

结果显示在下面。

Unresolved directive in blockquotes.adoc - include::example$quote.adoc[tag=para2]

引用段落

如果引用或摘录超过一段,将文本放置在由四个下划线(____)组成的分隔线之间。

引用块语法
Unresolved directive in blockquotes.adoc - include::example$quote.adoc[tag=comp]

引用块语法的结果如下所示。

Unresolved directive in blockquotes.adoc - include::example$quote.adoc[tag=comp]

引用段落

你可以通过以下方式将一个单独的段落变成一个引用块:

  1. 用双引号包围起来

  2. 在引用文本下方添加一个可选的归属说明(以两个破折号为前缀)

引用段落语法
Unresolved directive in blockquotes.adoc - include::example$quote.adoc[tag=abbr]

引用段落语法的结果如下所示。

Unresolved directive in blockquotes.adoc - include::example$quote.adoc[tag=abbr]

Markdown风格的引用块

Asciidoctor支持Markdown风格的块引用。这种语法被采用是为了方便从Markdown过渡,并且因为它是电子邮件消息中最常见的引用方法。

Markdown风格的引用块语法
Unresolved directive in blockquotes.adoc - include::example$quote.adoc[tag=md]

Markdown风格的引用块语法的结果显示如下。

Unresolved directive in blockquotes.adoc - include::example$quote.adoc[tag=md]

就像Markdown一样,Asciidoctor支持在blockquote内部包含一些块级内容,包括段落、列表和嵌套的blockquote。

Markdown样式的块引用包含块内容
Unresolved directive in blockquotes.adoc - include::example$quote.adoc[tag=md-alt]

这是如何呈现来自Markdown样式的块引用包含块内容的对话。

Unresolved directive in blockquotes.adoc - include::example$quote.adoc[tag=md-alt]

请注意,并非所有AsciiDoc块元素都支持在Markdown样式的引用块内。特别是,不允许使用描述列表。解析器在查找描述列表后,才会寻找Markdown样式的引用块,这意味着描述列表具有优先权。由于引用标记是描述列表术语的有效前缀,因此在这种情况下不会识别Markdown样式的引用块。如果您需要在引用块内放置描述列表,应该使用AsciiDoc语法来代替Markdown的引用块语法。

Markdown样式的引用块应仅在简单情况下使用,以及从Markdown迁移时使用。如果可能的话,应该始终优先使用AsciiDoc语法。