27.5.2.4 Assigning a title with a file name

You can assign title text to the name of a split or extract file, to specify a title explicitly; this assignment takes precedence over a title for the same file specified with a format. You must assign the title text to the internal file name assigned by DITA2Go (see §27.5.1 Understanding how split and extract files are named), not to any replacement name you may have specified for a split or extract file. For example:

[Titles]
; html filename = title, overrides [HTMLParaStyles] Title setting
; for split or extract files, use FileID+UID, such as mr516387
af345674=HTML Help, JavaHelp, and Oracle Help for Java
ba134256=Export dialog

Macros and macro variables

You can use macros and macro variables in the [Titles] section. For example, suppose you want to use as a title the name of the DITA file from which the HTML file was generated:

[Titles]
*=<$$_basefile>

This setting would provide the base name (without extension) of the DITA source file as the title of each HTML output file. However, a more efficient way to do the same thing would be to assign macro variable <$$_basefile> to the Title keyword; see §27.5.2.7 Assigning a computed title.

See also:

§3.6 Using wildcards in configuration settings

§37.3.4 Using predefined macro variables

Previous Topic:  27.5.2.3 Specifying a title prefix or suffix

Next Topic:  27.5.2.5 Assigning a title with a marker

Parent Topic:  27.5.2 Specifying page titles for split or extract files

Sibling Topics:

27.5.2.1 Understanding title assignment precedence

27.5.2.2 Assigning a title with a paragraph format

27.5.2.3 Specifying a title prefix or suffix

27.5.2.5 Assigning a title with a marker

27.5.2.6 Assigning a default title

27.5.2.7 Assigning a computed title