15.11.2 Specifying how to treat FrameMaker variables

To specify a treatment for FrameMaker user variables and a few FrameMaker system variables in DITA XML:

[DITAOptions]

; VariableType = Text (default),

;  Entity (for compatibility with DITA-FMx import),

;  or Conref (referring to a variable library file).

VariableType = Text

This setting affects all FrameMaker user variables in your document and also the following FrameMaker building-block system variables:

Volume Number

Chapter Number

Section Number (FrameMaker version 9+)

Subsection Number (FrameMaker version 9+)

When VariableType=Text (the default), FrameMaker variables are converted to text before they are included in DITA XML output.

When VariableType=Entity, each FrameMaker variable used in a topic becomes an entity. The entity name is the name of the variable, with spaces and any punctuation removed; case is preserved. The entity definition is plain text only; character formatting present in the FrameMaker definition of the variable is omitted. Each topic contains entity declarations only for the entities actually used in that topic. This method allows DITA-FMx to recognize FrameMaker variables on re-import of the generated DITA files.

See also:

§15.11.3 Treating FrameMaker variables as conrefs

---

> 15 Converting to DITA XML > 15.11 Exporting FrameMaker variables to DITA XML > 15.11.2 Specifying how to treat FrameMaker variables