7.2 Customizing Output Target Names ¶

Similar to file names, so-called target and id names may be set. The id is placed where the item is located, while the target is used to construct references to that item. The id and target are the same. A function used to set both target and file name is also described here.

The following function reference is for target items (nodes, anchors, floats), including for external manuals:

Function Reference: $target label_target_name ($converter, $normalized, \@node_contents, $default_target) ¶

$converter is a converter object. $normalized is the normalized node name, \@node_contents is a reference on an array containing the Texinfo tree contents of the command label. $default_target is the target that has been already set. The function should return the target ($target).

The element corresponding to the label can be found with label_command if the label corresponds to an internal reference (see Target Commands Links, Texts and Associated Commands):

my $element;
$element = $converter->label_command($normalized)
  if (defined($normalized));

For sectioning commands, in addition to the sectioning command target, targets for the sectioning command in table of contents and in short table of contents are needed. The following function reference is for sectioning command related target and file name:

Function Reference: ($target, $target_contents, $target_shortcontents, $file) sectioning_command_target_name ($converter, \%section_element, $default_target, $default_target_contents, $default_target_shortcontents, $file_name) ¶

$converter is a converter object. \%section_element is the Texinfo element corresponding to the sectioning command.

$default_target, $default_target_contents and $default_target_shortcontents are the targets that have been already set for the sectioning element and the sectioning element in table of contents and in short table of contents. $file_name is the file name that has been already set.

The function should return the $target, $target_contents and $target_shortcontents sectioning element target and sectioning element in table of contents and in short table of contents targets, and the file name for the sectioning element ($file).