Skip to main content
Participating Frequently
November 3, 2008
Question

Cross-references in DITA files

  • November 3, 2008
  • 4 replies
  • 1026 views
Adobe Technical Support sent me here. I hope someone here can help.

I have a DITA map file and XML files. Within some of the XML files, I used the fm-xref element to create cross-references to XML files which are also in the DITA map.

When I select DITA > Build FM DITABook from DITA Map file, I get a nice FM book file with xml.fm files in it. Just ducky, except for the cross-references. The cross-references in the xml.fm files still point at the source XML file. I expected that the cross-references would point to the corresponding locations in the new xml.fm files, not to the original source files. After fiddling with FM for a while, I couldn't figure out what to do.

So, I contacted Adobe Tech Support, and they said, "This can happen if you do not have your read/write rules set correctly. By default, cross references will point to the XML unless specified differently. For information on how to set your read/write rules, I would suggest
this webpage: http://www.adobe.com/devnet/framemaker/pdfs/Structure_Dev_Guide.pdf. There is a whole chapter in the PDF about read/write rules."

So I spent an afternoon reading about read/write rules. I'm sorry to say that I gained no insight on how to fix this. I contacted tech support again, and they assured me that 1) it is the read/write rules and 2) they don't know how read/write rules work.

Does anyone know the read/write rule that will force FM to point the fm-xref element to the new file instead of the original file? Would you care to share? Thanks!
This topic has been closed for replies.

4 replies

Participating Frequently
November 28, 2008
Hello Mr. Aimino,

this behaviour with the cross-references is something we have laboured under and relayed to Adobe time after time ourselvers, and which Adobe hopefully will have fixed in FrameMaker 9.

Apart from using DITA-FMx, another way is to use the XRefWizard Plugin from WestStreet Consulting. It can resolve cross-references based on ID alone.

With kind regards,
Franz.
______________
[SYSTEC - the document processing company.]
http://www.systec-gmbh.com/sites/toolbox.php
http://www.systec-gmbh.com/sites/ditapack.php
http://www.systec-gmbh.com/sites/3dpack.php
____________
|Schreiberhauer Str. 5 |D-90475 Nuernberg - Germany
|Phone +49 911 998955-625 |Fax +49 911 998955-663
|e-Mail info@systec-gmbh.com |Internet: www.systec-gmbh.com
|Redaktion, Übersetzung: www.systec-td.de |ePublishing, Lösungen: www.systec-it.de
____________
|Geschäftsführer: Dipl.-Ing. (FH) Georg Eck, Dipl.-Btw. (FH) Manfred Papp
|Amtsgericht Nürnberg HRB 9369
|Umsatzsteuer-Identifikationsnummer DE 133560519
______________
Participating Frequently
November 4, 2008
Technical support may not understand R/W issues because that sort of thing is handled by developer support.
Participating Frequently
November 3, 2008
OK, thank you! At least I won't waste any more time on r/w rules.
Participating Frequently
November 3, 2008
Hi Michael...

I think the tech support person didn't understand what was going on. The r/w rules have nothing to do with this issue. This is one of the known "issues" with the default FM8 DITA map to book conversion process .. unfortunately I don't know of any way around this problem. You might be able to make it work with some modifications to the XSLT import script (you won't be able to "fix" it, but given certain assumptions, you might be able to make it work for your files).

BTW .. DITA-FMx does handle this situation properly. (http://www.leximation.com/dita-fmx).

Regards,

...scott

Scott Prentice
Leximation, Inc.
www.leximation.com