DITA Options

Specify options that define the functionality of DITA-FMx.

The following options control many of the features in DITA-FMx.

DITA Topic Application
The name of the Topic structure application used when a DITA topic file is opened by the plugin (such as when you reference a topic from a topic or a map).
DITA Map Application
The name of the Map structure application used when a DITA map is opened by the plugin (such as when you reference a map from another map).
DITA Book Application
The name of the Book structure application used by the Generate Book from Map command.
Default ID Prefix
The string that is used as a prefix on IDs that are automatically generated.
Default “New” Type
Specifies the file extension applied to new topic files when one is not provided as part of the file name.
DITA-OT Directory
Specifies the root directory of the DITA-Open Toolkit to be used by the Generate Output command. If you don’t make use of the DITA-OT, you may leave this field empty.
Max Reference Levels
Specifies the number of nested files that are opened due to the auto-loading of references (xref or conref). If your files never have references within references (such as an xref within a conref), then you should set this to a value of “1.” If your files do make use of nested references, set this value equal to the maximum number of reference levels that exist. The greater the number the longer it may take to open files since all references in all opened files will resolve (unless limited by this option). Valid values are 1 through 9 or “*” (asterisk means unlimited levels).
Auto-Load Conrefs on File Open
On file open, any conrefs are resolved. Note that this auto-loading is applied to all files opened as a result of a reference in that file being resolved. The number of levels of reference resolution is determined by the Max Reference Levels option.
Auto-Load Xrefs on File Open
On file open, any xref (or fm-xref) elements are resolved. Note that this auto-loading is applied to all files opened as a result of a reference in that file being resolved. The number of levels of reference resolution is determined by the Max Reference Levels option.
Conditionalize Prolog on File Open
On file open, the prolog element is tagged with the “DITA-Prolog” condition. If this condition does not exist, it is created, and set to “Show.” If this condition already exists in the template, the condition is applied and the current Show/Hide state is used.
Conditionalize Topicmeta on File Open
On file open (of a map), the topicmeta element is tagged with the “DITA-Topicmeta” condition. If this condition does not exist, it is created, and set to “Show.” If this condition already exists in the template, the condition is applied and the current Show/Hide state is used.
Conditionalize Comments on File Open
On file open, any draft-comment elements are tagged with the “DITA-Comment” condition. If this condition does not exist, it is created, and set to “Show.” If this condition already exists in the template, the condition is applied and the current Show/Hide state is used.
Auto-Add IDs if Required by Element
When an element is inserted that has a required ID attribute, that attribute value is automatically added.
Wrap New Topics in DITA Element
When a new topic file is created (using the New DITA File command), the new file is created with a dita element at its root.
Add Hypertext Marker to External Xrefs
On file open or on insertion of an external xref (one that has the scope attribute set to “external”), a FrameMaker Hypertext marker is added so that this element is hyperlinked when a PDF is generated through FrameMaker.
Auto Smart-Spaces
Turns the FrameMaker Smart Space feature on and off as the insertion point is moved into and out of a preformatted element.
Check for XML Comments
On file open, a message displays at the console window if the file contains XML comments.
Fix Line Breaks in “topic/pre” Elements
In order to deal with a “bug” in FrameMaker, on file save this option adds a space between the end of an inline child element and the end of line in a preformatted (code) element. If an inline child element starts at the beginning of a line within a preformatted element, this option moves the start element to the previous line and adds a space between it and the line end.
Related information
INI-Only Settings