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.

14 lines
932 B

4 years ago
////
Included in:
- user-manual: Macro and Block Passthroughs
////
The passthrough is the primary mechanism by which to escape content in AsciiDoc (far more comprehensive and consistent than using a backslash).
As the name implies, a passthrough passes content directly through to the output document without applying any <<user-manual#subs,substitutions>>.
When using the passthrough block or macro, it's possible to specify a custom set of substitutions to be applied before the content is reintroduced.
Other forms of passthroughs, such as the single and double plus, apply substitutions strictly for compliance with the output format.
WARNING: Using passthroughs to pass content (without substitutions) can couple your content to a specific output format, such as HTML.
In these cases, you should use conditional preprocessor directives to route passthrough content for different output formats based on the current backend.