### 38.4 Assigning properties to PI marker types

You can define the behavior of a new PI marker type, or redefine the behavior of an existing PI marker type, by assigning one or more properties to the PI marker type:

    [MarkerTypes]
    ; PI marker type name = properties
    Marker = Property1 Property2 ...

Which properties you can assign depends on whether you are converting to HTML or to RTF. A few properties are common to both output types: Delete, Code, ALink, and Config. The rest are specific to either HTML or RTF output. Table 38-3 lists all the [MarkerTypes] properties, shows which output types apply, and describes the effect of each property.

Table 38-3 Effects of [MarkerTypes] properties

Output | Property | Effect
RTF or HTML |
    ALink
| Content is treated as a list of names of categories that apply to the current topic. Category names should be single terms, separated by semicolons. Use spaces or other punctuation in the names at your own risk. Available for WinHelp, MS HTML Help, OmniHelp, and Oracle Help for Java.
    Code
| Any macros in the marker are expanded, and the content is surrounded by any code specified for the marker type in [MarkerTypeCodeBefore] and [MarkerTypeCodeAfter]; see §38.5 Inserting code with PI markers for more information. Cannot be combined with HTMLComment.
    Config
| Content is a configuration setting of the form [Section]Key=Value or [Section]=Value; see §42.2 Overriding settings with PI markers or macros.
    Delete
| The marker is removed entirely; DITA2Go applies this property last, after any other properties you specify. Must be specified last.
RTF only |
    RTFConfig
| Content is a configuration setting of the form [Section]Key=Value or [Section]=Value; see §42.2 Overriding settings with PI markers or macros.
HTML only |
    ANSI
| Specifies the Windows code page to use, default 1252; or 1250 for CE/EE, 1251 for Cyrillic, 1253 for Greek, 1254 for Turkish.
    Extr*
| Each of these markers has the same effect as the corresponding [HTMLParaStyles]parafmt=Extr* property; see §27.4.1 Enabling and disabling extract processing. For ExtrDisable, ExtrEnable, ExtrEnd, and ExtrStart, any content is ignored, unless you also specify other properties that use the content, such as Code.
       ExtrBottom
| Content becomes the last item in the extract <body>.
       ExtrDisable
| Turns extract processing off.
       ExtrEnable
| Turns extract processing on.
       ExtrEnd
| Ends a file extract, but is not part of the extract.
       ExtrFinish
| Ends a file extract, and is the last part of the extract.
       ExtrHead
| Content is placed in the <head> of the extract, after the <title> element.
       ExtrReplace
| Content replaces an extract in the parent file.
       ExtrStart
| Begins an extract. Must be specified before FileName or Title.
       ExtrTop
| Content becomes the first item in the extract <body>.
    FileName
| Marker content names the current split or extracted file; dangerous (see §43.3.2 Using PI markers to name output files)
    HelpMerge
| Marker content specifies another help file to be merged at the point of insertion
    HTMConfig
| Content is a configuration setting of the form [Section]Key=Value or [Section]=Value; see §42.2 Overriding settings with PI markers or macros.
    HTMLComment
| Marker content is treated as an HTML comment, and enclosed within HTML comment delimiters; or, if you specified XML as the output type, marker content is properly converted to an XML comment. Cannot be combined with Code.
    Split
| Marks a split point in a DITA file; has the same effect as [HTMLParaStyles]parafmt=Split; see §27.3.1 Designating split points. Any content is ignored, unless you also specify other properties that use the content, such as Code. Must be specified before FileName or Title.
    Title
| Marker content becomes the page title attribute of the current split or extract file.
    TopicStartCode
| Same as the Code property, except macros are expanded at the start of the topic. Any output the macros create is available as predefined macro <$_TopicStartCode>, which can be used anywhere in the current topic.
    Window
| HTML Help only. Marker content names a secondary window as the target for jumps from the paragraph containing the marker.

Previous Topic: 38.3 Adding attributes with PI markers

Next Topic: 38.5 Inserting code with PI markers

Parent Topic: 38. Working with processing instructions

Sibling Topics:

38.1 Understanding DITA2Go PI markers

38.2 Understanding effects of PI markers

38.3 Adding attributes with PI markers

38.5 Inserting code with PI markers

Table of Contents • Index