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)耦合在一起。在这些情况下,您应该使用条件预处理指令,根据当前后端为不同的输出格式路由直通内容。 |