(register)   username:   password:  

Community KB :: DITA / FrameMaker

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

Tags:                                        
Keywords: 

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.