7.10 Formatting of complex formats (@example, @display…)

Here we see how a whole complex format is formatted. For the formatting of the text, see Formatting (or not) a paragraph and a preformatted region.

The formatting of the complex formats is ultimately controlled by a function, however the default for this function uses a hash reference and changing the hash reference values should be enough in most cases. This hash reference is called $complex_format_map. It has a key for each of the complex format commands (example, smallexample, lisp, smalllisp, display, smalldisplay, format, smallformat).

The associated value is also a reference on a hash. The keys are:

begin

An eval of begin should lead to the beginning of the formatted HTML.

end

An eval of end should lead to the end of the formatted HTML.

class

The HTML class. If not defined, the command name.

pre_style

The preformatted style. If not defined the corresponding CSS style is used.

The enclosed text will be formatted as described in Formatting (or not) a paragraph and a preformatted region, and the name of the complex format will be available to the function formatting the text.

If you aren't satisfied with this scheme, you can redefine the following function reference for a better control over the complex format formatting:

Function Reference: $complex_format_text complex_format $format_name $preformatted_text

$format_name is the complex format name, $preformatted_text is the text allready formatted as described in Formatting (or not) a paragraph and a preformatted region. This function returns the whole complex format.

Doku-Base