散文摘录、引用和诗句共享相同的语法结构,包括:
-
区块名称,可以是
quote
或者 `verse -
内容归因于谁的名字
-
书籍、演讲、戏剧、诗歌等内容来源的参考文献信息
-
选段文本
基本引用语法
对于不需要保留换行符的内容,请将`quote`属性设置在属性列表的第一个位置。接下来,设置归因和相关的引证信息。这些位置属性都是可选的。
[引用,署名,引用标题和信息] 引用或摘录文本
你可以在分隔每个位置属性的逗号后包含一个可选的空格。如果属性值包含逗号,请将该值用双引号或单引号括起来。
如果引用是单行或者段落(即,一个有样式的段落),你可以直接将属性列表放置在文本上方。
Unresolved directive in blockquotes.adoc - include::example$quote.adoc[tag=para2-c]
-
使用句点(
.
)作为标记的引导文本,解释引用的上下文或设置。(可选) -
对于不需要保留换行符的内容,请在属性列表的第一个位置设置`quote`。
-
第二个位置包含节选内容的归属者。(可选)
-
在第三个位置输入额外的引用信息。(可选)
-
将摘录或引用文本输入紧跟在属性列表之后的那一行。
结果显示在下面。
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]
引用段落
你可以通过以下方式将一个单独的段落变成一个引用块:
-
用双引号包围起来
-
在引用文本下方添加一个可选的归属说明(以两个破折号为前缀)
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过渡,并且因为它是电子邮件消息中最常见的引用方法。
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。
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语法。