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

A
AL24Author
Known Participant
May 24, 2011

Nope. The exact same limitations will apply. If a reference is to a file that's outside of the "scope" of the current map (i.e., it's not a topic within the map), you'll need to use an "external" reference and use the "file:" or "http:" protocol.

...scott


OK, thanks.

Then, it's not clear to me how to define the path in the external reference

when I create it in my DITA source.

Say for ex: that I need to create a link to the section "Prerequisites" in

the PDF named "ScreeningProcedure.pdf".

How would the path look like?

Thanks

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