Related links to non-DITA resources in PDF output

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 » Wed May 15, 2019 3:17 pm

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?

Radu
Posts: 6343
Joined: Fri Jul 09, 2004 5:18 pm

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

Post by Radu » Thu May 16, 2019 10:41 am

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

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 » Thu May 16, 2019 3:11 pm

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.

Radu
Posts: 6343
Joined: Fri Jul 09, 2004 5:18 pm

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

Post by Radu » Mon May 20, 2019 9:30 am

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

Post Reply