Related links to non-DITA resources in PDF output

Post here questions and problems related to editing and publishing DITA content.
Post Reply
U-Joe
Posts: 6
Joined: Mon Feb 18, 2019 3:03 pm

Related links to non-DITA resources in PDF output

Post by U-Joe »

Hi,

I've added related links section to the topic, here it is:

Code: Select all

<related-links>
    <link href="topicname.dita"></link>
    <link href="http://www.oxygenxml.com" format="html" scope="external">
      <linktext>Example</linktext>
    </link>
  </related-links>
It looks fine both in Webhelp responsive and Word outputs. PDF output displays the first local link without any problem, but the second external link doesn't appear in the output, Oxygen shows the next info message:
[DOTX073I]: Removing broken link to "http://www.oxygenxml.com".
I tried both args.rellinks=default and args.rellinks=all, but the result is the same. Is this limitation of the engine, or do I do something wrong?
Top
Radu
Posts: 9059
Joined: Fri Jul 09, 2004 5:18 pm

Re: Related links to non-DITA resources in PDF output

Post by Radu »

Hi,

This looks like a publishing bug but I cannot reproduce it with Oxygen 21 and its bundled DITA OT 3.x engine.
I'm trying on my side to publish a small DITA Map having a reference to a topic which looks something like:

Code: Select all

<!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
<topic id="introduction">
    <title>Introduction</title>
    <shortdesc>A</shortdesc>
    <body>
        <p>B</p>
    </body> 
	<related-links>
		<link href="t2.dita"></link>
		<link href="http://www.oxygenxml.com" format="html" scope="external">
			<linktext>Example</linktext>
		</link>
	</related-links>
</topic>
but it works for me, I tested with both the XSL-FO based PDF and the CSS-based PDF.
So what version of Oxygen are you using for publishing? Also are you using Oxygen's bundled DITA OT engine or a custom DITA OT version?

Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
Top
U-Joe
Posts: 6
Joined: Mon Feb 18, 2019 3:03 pm

Re: Related links to non-DITA resources in PDF output

Post by U-Joe »

Thanks for your reply.

I use Oxygen 21 and its bundled DITA OT 3.x engine. The transformation scenario is modified CSS-based Dita Map PDF.
I've checked the situation using default CSS-based Dita Map PDF transformation scenario and found the solution. The reason is remove-broken-links parameter was set true. This is strange, however, because links weren't broken. Sorry for wasting your time, the first thing I had to do is to check the parameters.
Top
Radu
Posts: 9059
Joined: Fri Jul 09, 2004 5:18 pm

Re: Related links to non-DITA resources in PDF output

Post by Radu »

Hi,

I reproduced the problem with that specific parameter enabled. I also consider it to be a bug, the parameter should not behave like this.
I added an issue for it in the DITA OT issues list:

https://github.com/dita-ot/dita-ot/issues/3309

Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
Top
Post Reply

Return to “DITA (Editing and Publishing DITA Content)”