You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

42 lines
1.2 KiB

4 years ago
////
Included in:
- user-manual: Macro and Block Passthroughs: Block passthroughs
////
The passthrough block and `pass` block style exclude block content from all substitutions (unless specified otherwise).
A passthrough block is delimited by four plus signs (`{plus}{plus}{plus}{plus}`).
The `pass` style is implied.
[source]
----
include::ex-pass.adoc[tag=bl]
----
(Keep in mind that AsciiDoc has a video macro, so this example is merely for demonstration.
However, a passthrough could come in handy if you need to output more sophisticated markup than what the built-in HTML converter produces).
The pass style can also be set on a paragraph or an open block.
[source]
----
include::ex-pass.adoc[tag=pass-style]
----
You can use the `subs` attribute to specify a comma-separated list of substitutions.
These substitutions will be applied to the content prior to it being reintroduced to the output document.
[source]
----
include::ex-pass.adoc[tag=subs-bl]
----
The content of the pass block does not get wrapped in a paragraph.
Therefore, you can use the `pass` style in combination with the `normal` substitution category to output content without generating a paragraph.
[source]
----
include::ex-pass.adoc[tag=no-para]
----