pass` 样式和分隔的直通块将把块内容排除在所有替换之外,除非设置了 subs 属性。

传递风格的语法

pass` 样式也可以被设置在一个段落或一个开放的区块上。

Unresolved directive in pass-block.adoc - include::example$pass.adoc[tag=pass-style]

限定的透传块语法

通透区块由四个加号(++++)限定。

Unresolved directive in pass-block.adoc - include::example$pass.adoc[tag=bl]

请记住AsciiDoc有一个视频宏,所以这个例子仅用于演示。然而,如果你需要输出比内置的HTML转换器产生的更复杂的标记,那么直通可能会派上用场。

对透传块进行控制替换

您可以使用subs属性来指定逗号分隔的替换列表。这些替换将在内容重新引入输出文档之前应用。

Unresolved directive in pass-block.adoc - include::example$pass.adoc[tag=subs-bl]

pass块中的内容不会被包裹在段落中。因此,你可以将`pass`样式与`normal`替换类别结合使用来输出内容,而不生成段落。

Unresolved directive in pass-block.adoc - include::example$pass.adoc[tag=no-para]
Warning
使用直通方式传递内容(不经过替换)可能会将您的内容与特定的输出格式(例如HTML)耦合在一起。在这些情况下,您应该使用条件预处理指令,根据当前后端为不同的输出格式路由直通内容。