Conref to remote resource not resolving

Having trouble installing <oXygen/>? Got a bug to report? Post it all here.
d_croft
Posts: 20
Joined: Fri Feb 20, 2015 10:25 am

Conref to remote resource not resolving

Post by d_croft » Fri Dec 21, 2018 11:03 am

Hi,

I'm having trouble using external resources as conref targets in my DITA material. I want to embed some source code from Github to my documentation files, but Oxygen isn't letting me do that.

Getting the following error when transforming the material to HTML:

Code: Select all


Description: [DOTJ051E] Unable to load target for coderef "https://raw.githubusercontent.com/MyCashflow/Default-Email-Templates/master/src/pages/order/shipping-notification.html".
Using DITA-OT 3.2 for the transformation.

This used to work at some point but not anymore. Is it because of the newer DITA-OT version?

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

Re: Conref to remote resource not resolving

Post by Radu » Mon Dec 24, 2018 11:02 am

Hi,

This problem is related more to the publishing engine, especially as you are using a custom publishing engine and all Oxygen does is to run it.
I will assume your coderef looks like this:

Code: Select all

            <coderef href="https://raw.githubusercontent.com/MyCashflow/Default-Email-Templates/master/src/pages/order/shipping-notification.html" format="html"/>
I tested also with DITA OT 2.x and it failed exactly the same as DITA OT 3.2 to properly retrieve it. There is an issue registered for this:

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

In the Oxygen transformation scenario you are using there is a parameter called something like fix.external.refs. If you enable this parameter, Oxygen has some custom code which tries to download such resources in a way in which the publishing engine properly finds them.

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

Post Reply