7.13 Customizing headings formatting

A function controls the formatting of sectioning element headings, with the corresponding function reference:

Function Reference: $heading_text heading \%element_reference

The \%element_reference is a reference on a hash corresponding with the sectioning element. The following keys are of interest:

text

The heading text

name

The heading text without section number

node

true if the sectioning element is a node without associated structuring command

level

The level of the element in the document tree. ‘0’ is for @top, ‘1’ for @chapter and so on

tag_level

the sectioning element name, with @raisesections and @lowersections taken into account

It is also possible to customize the heading text with section number with the following function reference (called for headings and nodes):

Function Reference: $result_texi heading_texi $heading_command $heading $number

$heading_command is the sectioning @-command of that heading. $heading is the texinfo for that heading. $number is the heading number classicaly computed with dots between numbers, and letters for top level appendix numbering. This function should return the texinfo text corresponding with the numbered heading.

Doku-Base