$v:verbatim-syntax-highlight-options

$v:verbatim-syntax-highlight-options — Syntax highlighting options.

Variable:
{http://docbook.org/ns/docbook/variables}verbatim-syntax-highlight-options
Defined in:
modules/variable.xsl
Used in:
modules/verbatim.xsl

Synopsis

$v:verbatim-syntax-highlight-options := map { }

Description

If the Pygments syntax highlighter is applied, the $verbatim-syntax-highlight-options are applied.

Three options are recognized:

language

The programming language to use for syntax highlighting. This option is required.

show-command

If the show-command option is true (“1”, “yes”, or “true”), then the pygmentize command will be printed. This is a debugging option.

show-result

If the show-result option is true (“1”, “yes”, or “true”), then the string returned from pygmentize will be printed. This is a debugging option.

Note

Syntax highlighting with Pygments requires spawning an external process for each highlighted environment. This can add significantly to the processing time if there are many such environments.