##### 27.4.2.3 Using markers to delimit extracts

You can specify the boundaries of an extract with carefully placed PI markers. DITA2Go ignores the content of these markers, so you can use the content for comments:

ExtrStart | First part of an extract; insert in the first paragraph in the extract, to the left of any Title, FileName, or Cross-Ref marker that occurs in the same paragraph.
ExtrFinish | Last part of an extract; insert in the last paragraph of the extract.
ExtrEnd | End of an extract; insert after the last paragraph of the extract, and before the end of the next paragraph.

For easy maintenance, the best place for these markers is at the start of a paragraph.

To extract a single paragraph, insert both ExtrStart and ExtrFinish PI markers in the paragraph; the ExtrStart marker must precede the ExtrFinish marker.

ExtrFinish and ExtrEnd markers are alternate ways to end an extract. You do not have to use both, but doing so is harmless. If you do not use one or the other, the extract ends gracefully at the next split point, or at the end of the file.

Note: For any of these markers to take effect, you must enable extracts; see §27.4.1 Enabling and disabling extract processing.

Previous Topic: 27.4.2.2 Creating special paragraph formats to delimit extracts

Next Topic: 27.5 Identifying split and extract files

Parent Topic: 27.4.2 Delimiting material to extract

Sibling Topics:

27.4.2.1 Using existing paragraph formats to delimit extracts

27.4.2.2 Creating special paragraph formats to delimit extracts

Table of Contents • Index