建立一个定界块
在这一部分中,我们将创建一个有分隔符的侧边栏块。侧边栏样式的分隔符是四个星号(****
)。
-
在新行的开始处输入开头定界符,然后按下kbd:[Enter]。
你的文档中的文本。 星号通常不代表任何特定的语言文字,因此没有可以翻译的内容。如果 ```****``` 代表某种特定信息或需要按照某种方式翻译,请提供更多上下文或具体的翻译要求。
-
在新的一行中输入你的内容,比如段落、限定块、指令和宏。限定块的样式将应用于所有这些内容,直到闭合定界符。
你的文档中的文本。 **** 这是侧边栏区域的内容。 image::name.png[] 这是侧边栏块中的更多内容。
-
要结束界定块,你需要在最后一行内容的末尾按下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[]