8.3 Customizing External Node Output Names

In the default case references to external nodes are set as described in the Texinfo manual (see HTML Xref in Texinfo). You can specify external node manuals URLs in cross-references customization files (see HTML Xref Configuration in Texinfo). You can also set a base directory, the Top node file target, the extension and other overall references to external nodes formatting with customization variables (see File Names and Links Customization for HTML in Texinfo).

If the external reference is not already ignored because of IGNORE_REF_TO_TOP_NODE_UP, two function references give full control over the external node target output names, with external_target_split_name if the external target is considered to be split, and external_target_non_split_name if the external target is non split.

Function Reference: ($target, $host_directory, $file_name) external_target_split_name($converter, $normalized, \%element, $default_target, $default_host_directory, $default_file_name)

$converter is a converter object. $normalized is the normalized node name, \%element is a reference on an element containing information on the external node.

$default_target, $default_host_directory and $default_file_name are the target, host and directory URL part and file name URL part that have been already set.

The function should return the $target, $host_directory and $file_name URL parts.

Function Reference: ($target, $host_directory_file) external_target_non_split_name($converter, $normalized, \%element, $default_target, $default_host_directory_file)

$converter is a converter object. $normalized is the normalized node name, \%element is a reference on an element containing information on the external node.

$default_target is the target and $default_host_directory_file is the host and file name part of the URL that have been already set.

The function should return the $target and $host_directory_file URL parts.