#### 27.8.2 Customizing title text for extracts

In the [ExtrTitle] section you can assign text for the extract title to the ExtrStart format or ExtrStart PI marker, whichever you used to designate the start of the extract:

    [ExtrTitle]
    ; doc format = text for title of the extract file, which may use
    ;   macros, including <$$_currtitle> which has the title of the parent
    ;   file.  This is ignored if the Title is set for any para in the
    ;   extract file.
    ExtractStartPara=Title for extract file

Predefined macro variable <$$_currtitle> is the <title> string of the file that originally contained the extracted text; see §27.7 Referencing split and extract files.

For example, suppose your DITA document contains an element mapped to a paragraph format that always marks the start of an extract; for example ProcedureStart; and suppose you want each such extract to have a title that includes the title of the file from which it was extracted. You could achieve this effect with the following setting:

    [ExtrTitle]
    ProcedureStart=<$$_currtitle>: Procedure

If the original file’s <title> string was “Setting up a customer account”, the extract file’s <title> section would be:

    <title>Setting up a customer account: Procedure</title>

Note: If you assign [HTMLParaStyles] property Title to a paragraph format in the extract, the content of that paragraph overrides anything you specify in [ExtrTitle].

Previous Topic: 27.8.1 Using PI markers for extract processing

Next Topic: 27.8.3 Replacing extracts with links in the parent file

Parent Topic: 27.8 Customizing and replacing extracts

Sibling Topics:

27.8.1 Using PI markers for extract processing

27.8.3 Replacing extracts with links in the parent file

27.8.4 Specifying extracts: an example