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