(register)   username:   password:  

Community KB :: DITA / FrameMaker

A collection of tips and troubleshooting information. Feel free to register and add your own items.


FMN DITA .. refers to the DITA support that is provided by default in FM9 and FM8.

DITA-FMx .. is a plugin that provides extended DITA authoring support for FM9, FM8, FM7.2 and FM7.1. More info...

Submitted by: Scott Prentice (2008-01-21)
Last updated: 2008-06-19

TAGS:  OpenToolkit, Output, FM8 DITA, DITA-FMx 0.0, DITA-FMx 1.0, FM 7.1, FM 7.2, FM 8.0
SUMMARY:  FM-based cross-reference text shows up in OT-generated files
ISSUE:  Using the fm-xref element allows the use of FM-style cross-refs in content (PDFs) generated from FrameMaker. However, if you also generate output through the OT, the text of the FM-style cross-refs will be used as the link text. This is most likely not what you want.
SOLUTION:  Correcting this problem requires manually updating the ditafmx.ini (for DITA-FMx) or ditafm.ini (for FM8-DITA). Set the GeneralExport/WriteLinkTextToFmXrefs parameter in the INI file to 0. The default for this (perhaps incorrectly) is 1, which saves the cross-reference text of fm-xref elements to the XML file. This "hard-codes" the link text value and doesn't allow the OT to rebuild them with the title text of the target topic. If you set this to 0 (zero), the link text won't be saved to the XML file.

Note that after changing this setting, you'll have to open/save/close all of your XML files to remove the embedded link text. After you do that, the links in your OT-generated content should be free of the FM-xref text.