##### 27.5.2.2 Assigning a title with a paragraph format

For the page title of a split or extract file, you can use the content of the heading that caused the split or extract, or the content of the first instance of any other paragraph in the split or extracted part. Optionally, you can also specify a prefix or suffix or both; see §27.5.2.3 Specifying a title prefix or suffix.

Heading content as title

To use the content of a heading as a page title, assign the Title property to the heading paragraph format; for example:

    [HTMLParaStyles]
    ; Title uses head as HTML page title, see [Titles]; may be preceded
    ;  by [StyleTitlePrefix] and followed by [StyleTitleSuffix]
    FigCaption=ExtrStart Title
    Heading2=Split Title

Headings in tables

Normally DITA2Go does not create a page title if the heading for which [HTMLParaStyles] has the Title property is within a table. If you need titles from headings in tables (for example, if your chapter headings are in single-cell tables) specify the following setting:

    [Tables]
    ; AllowTbTitle = No (default) or Yes (allow title from head in table)
    AllowTbTitle=Yes

Otherwise, an HTML page title will not be created from such a heading.

Macros and macro variables

If you use macros or macro variables in the text of a paragraph to which you have assigned the Title property, you must also assign property Raw; otherwise, the characters <, >, and & all get turned into HTML entities; and instead of being expanded, a macro appears literally in the output. See §30.2.4 Stripping paragraph properties.

See also:

§27.8.2 Customizing title text for extracts

§30.2.1 Assigning HTML tags and attributes to paragraph formats

Previous Topic: 27.5.2.1 Understanding title assignment precedence

Next Topic: 27.5.2.3 Specifying a title prefix or suffix

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.3 Specifying a title prefix or suffix

27.5.2.4 Assigning a title with a file name

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

Table of Contents • Index