##### 37.3.5.1 Capturing paragraph content with the TextStore property

To store the text content of a paragraph in a macro variable, assign the TextStore property to the paragraph format:

    [HTMLParaStyles]
    ; TextStore stores the paragraph content as plain text in the
    ;   macro variable named in [StyleTextStore].
    Parafmt = TextStore

Explicitly assigning the TextStore property to a paragraph format is optional when you assign a macro variable to that format in the following section:

    [StyleTextStore]
    ; doc para format = name of macro variable in which to store para text
    ;  if omitted, default is a macro variable of the para format name
    Parafmt = Varname

Format name is default variable name

If you assign the TextStore property to a paragraph format, but you do not supply a macro variable name in section [StyleTextStore], DITA2Go uses the paragraph format name itself as the macro variable name.

Plain text

TextStore macro variables contain just plain text; no HTML tags, RTF formatting code, macros, frames, or tables. Although the original paragraph content is left in place, you can suppress its appearance in output by also assigning the Delete property to the paragraph format.

Only last instance counts

If more than one instance of a TextStore paragraph format appears in a portion of your document destined for a given split or extract file, the TextStore macro variable retains the content of only the last instance, for that particular split or extracted file.

Location can follow point of use

For HTML, you can place a TextStore paragraph anywhere with respect to where you want the macro-variable content to be used, within the limits of material to be split or extracted into a single HTML output file; this is different from CodeStore paragraphs, which must precede the point of use (see §37.3.5.3 Understanding why TextStore and CodeStore work differently).

Content is persistent

The content of a TextStore macro variable persists unchanged in, and is available throughout, each HTML output file. If there is no instance of the paragraph format in the current split file, DITA2Go uses the content of the previous instance (or even a later instance) rather than come up empty-handed. Therefore, to prevent its use in a given split file, you must set the value to zero in that portion of the source document.

Previous Topic: 37.3.5 Creating macro variables from paragraph content

Next Topic: 37.3.5.2 Inserting code with the CodeStore property

Parent Topic: 37.3.5 Creating macro variables from paragraph content

Sibling Topics:

37.3.5.2 Inserting code with the CodeStore property

37.3.5.3 Understanding why TextStore and CodeStore work differently

Table of Contents • Index