10.4.2 Setting the Context for Conversion ¶

Special container types are recognized by the converter and can be used to convert a Texinfo tree in a specific context. Those types cannot appear in a regular Texinfo tree. In general they should be the type of tree root elements setup by the user.

The types are:

_code

In this container, the conversion is done in a code context See Init File Expansion Contexts: Normal, Preformatted, Code, String, Math. For a container tree element.

_converted

The text of this text element is considered to be already formatted.

_string

In this container, the conversion is done in a string context. See Init File Expansion Contexts: Normal, Preformatted, Code, String, Math. For a container tree element.

These contexts are typically used together with converter conversion functions (see Texinfo Tree Conversion Functions). For example:

my @contents = @{$element->{'contents'}};
push @contents, {'text' => ' <code>HTML</code> text ',
                   'type' => '_converted'};
my $result = $converter->convert_tree({'type' => '_code',
                                  'contents' => \@contents });