建立一个定界块

在这一部分中,我们将创建一个有分隔符的侧边栏块。侧边栏样式的分隔符是四个星号(****)。

  1. 在新行的开始处输入开头定界符,然后按下kbd:[Enter]。

    你的文档中的文本。
    
    星号通常不代表任何特定的语言文字,因此没有可以翻译的内容。如果 ```****``` 代表某种特定信息或需要按照某种方式翻译,请提供更多上下文或具体的翻译要求。
  2. 在新的一行中输入你的内容,比如段落、限定块、指令和宏。限定块的样式将应用于所有这些内容,直到闭合定界符。

    你的文档中的文本。
    
    ****
    这是侧边栏区域的内容。
    
    image::name.png[]
    
    这是侧边栏块中的更多内容。
  3. 要结束界定块,你需要在最后一行内容的末尾按下kbd:[Enter]键。在新的一行中,输入关闭界定符。

    你的文档中的文本。
    
    ****
    这是侧边栏区域的内容。
    
    image::name.png[]
    
    这是侧边栏模块中的更多内容。
    ****

这就是了。你已经构建了一个限定的区块。

从一个段落构建一个块

在某些情况下,你可以使用样式的名称来设计一个块。如果内容是连续的(没有被空行或注释行打断),你可以在内容上方放置一个属性列表来指定块样式的名称。这种格式通常用于单行列表:

Unresolved directive in build-basic-block.adoc - include::example$block.adoc[tag=opt-listing]

或单行引用:

Unresolved directive in build-basic-block.adoc - include::example$block.adoc[tag=quote-name]

然而,请注意,样式段落的行首先像段落一样解析,然后提升为指定的块类型。这意味着行注释将被删除,这可能会影响如列表块这样的逐字块。因此,特别是在创建逐字块时,首选限定块形式。

内置块的概述

下表列出了内置的块样式、它们的分隔符语法、用途以及对其内容执行的替代操作。

Unresolved directive in build-basic-block.adoc - include::partial$block-name-table.adoc[]