Skip to main content
A
AL24
Known Participant
April 12, 2011
Question

X-refs are not working in the PDF output

  • April 12, 2011
  • 1 reply
  • 2430 views

I correctly generated a PDF from a ditamap using DITA-FMx and cross-references are not working.

Thanks for your help.

This topic has been closed for replies.

1 reply

ScottPrentice
ScottPrentice
Inspiring
April 12, 2011

Are these local or external xrefs? For external xrefs you need to enable the "Convert xrefs/links to hyperlinks" option in the book-build Options. If these are internal links (to other topics in the project) .. first check the console window to make sure you didn't have any errors, then open the generated FM file with the xref. Locate the xref and check to make sure it points to the FM target and not the original XML target (in the @href attribute). You need to make sure that the "Normalize Reference Paths" and  "Reload References" options are also enabled in the Bookbuild Options.

Note that you may want to send DITA-FMx questions to the dita-fmx-users Yahoo list .. that's where you'll find a group of FMx users who can help with your questions.

Thanks,

...scott

A
AL24Author
Known Participant
May 9, 2011

Thanks for your reply.

I refer to internal links and the properties you mentioned are correctly set. In fact, the issue only concerns the topic-to-topic links across different ditamaps. The links created within the same ditamap work correctly.

To crete the link at the DITA level, I used the tag <fm-xref>.

Thanks

Arianna

ScottPrentice
ScottPrentice
Inspiring
May 9, 2011

Ah .. you're making links to topics in a different map? That won't work. If you look in the FrameMaker console window, you'll see an error message about an xref that points to a topic outside the scope of this map. An "internal" link is on that points to a topic that is within the same map. The only way to make a link to a topic outside of that scope is to use an "external" link, and you need to specify the actual location of that target in the target PDF.

This Community KB topic may help with the xref syntax ..

     http://kb.leximation.com/dfm/?kbid=61

Cheers,

...scott

Terms & ConditionsAccessibility statement
Using the community Terms of use Privacy Cookie preferences Do not sell or share my personal information ad choicesAdChoices