Page 1 of 1

Hyperlink disappers in pdf output

Posted: Thu Oct 25, 2012 6:44 am
by khcy82nvh
Hi guys

I am using default Apache DITA-OT to generate PDF output from my .dita files.

But when PDF output is generated, all hyperlinks (created by <keyref> tag in dita files, I also defined their correspoding <keys> in .ditamap)disappear. For your information, this issue does not happen if Oxygen generates CHM or WEBHELP outputs.

Please help me this issue

Thanks

Regards,

Re: Hyperlink disappers in pdf output

Posted: Thu Oct 25, 2012 9:19 am
by Radu
Hi,

There is no <keyref> tag in DITA.
What DITA element are you using to reference the keys defined in the DITA Map? <xref>?
What version of Oxygen do you have? Are you using the DITA OT which comes bundled with it or a custom DITA OT?

Regards,
Radu

Re: Hyperlink disappers in pdf output

Posted: Thu Oct 25, 2012 9:55 am
by khcy82nvh
I am using Oxygen 14.0

Below is a sample code:

In create_action.dita, I wrote:
<p>An action may be something elementary, such as <ph keyref="kbia_report" />..............
And in .ditamap, I defined the keys value:
<topicref navtitle="report" href="Topics/bia_report.dita" class="- map/topicref " type="reference" keys="kbia_report"/>
My purpose is to create a hyperlink for kbia_report.

This hyperlink appears and works well for chm and webhelp buidlds; however, in pdf build, the hyperlink disappers.

Re: Hyperlink disappers in pdf output

Posted: Thu Oct 25, 2012 11:22 am
by Radu
Hi,

I think that in this case the XHTML-type outputs are incorrect.
The link should be made using <xref keyref="kbia_report"/>. This works both in HTML and PDF.

This link explains things more clearly:

http://dita.xml.org/resource/dita-tc-faq-about-keys#Q2

Basically there are two types of DITA elements, elements which also accept @href as an attribute and these elements become links (like <xref/>) and elements which do not accept @href as an attribute (like <ph>) which only show the title of the referenced resource as plain text.
I may be wrong on this, you could also ask for clarifications on the DITA Users List.
The group of people who made the DITA standard are all members of the list.

Regards,
Radu

Re: Hyperlink disappers in pdf output

Posted: Thu Oct 25, 2012 1:52 pm
by khcy82nvh
Hi,

I have made changes to <xref keyref="kbia_report"/>. And it really work very well on PDF output.

Thank you so much