Page 1 of 1

Error resolving conref

Posted: Wed Dec 19, 2018 2:39 pm
by juhopvx
Hello,

I have a custom framework extended from the DITA framework. In this custom framework's catalog I have the following entries:

Code: Select all

<rewriteURI uriStartString="vx:docum/" rewritePrefix="../../"/>
<rewriteSystem systemIdStartString="vx:docum/" rewritePrefix="../../"/>
I am trying to make all references in this project relative to the project root. The above mechanism works just fine for images (href), but for conref elements Author mode displays an error:

Code: Select all

Error while parsing external reference.
Also when I try to run the DITA Map to CHM transformation for this project, I get:

Code: Select all

Transformation failed. <path>\DITA-OT2.x\plugins\org.dita.base\build_preprocess.xml:55: Failed to run pipeline: null
Should the rewritePrefix method work for conref elements at all? Or am I just doing something wrong here?

Re: Error resolving conref

Posted: Thu Dec 20, 2018 12:33 pm
by Radu
Hi,

I can reproduce the problem when it comes to resolving conrefs in the Author visual editing mode. And we can fix this on our side, Oxygen 21 will be available in February 2019 and we'll try to incorporate a fix for it.
The publishing part is another story, the DITA Open Toolkit publishing engine by default has no support for looking in XML catalogs when resolving conrefs, if you edit the transformation scenario in the Parameters list there is an Oxygen-specific "fix.external.references" parameter which you can set to "true". We have some custom code which will also try to resolve through XML catalogs such references and this may make the publishing work.
Honestly in such cases maybe you could use content key references because you already seem to need some indirection so why not use keys instead?

Regards,
Radu

Re: Error resolving conref

Posted: Fri Dec 21, 2018 10:12 am
by juhopvx
Good to know what caused this. I will look into content key references.

Thank you for your reply.

Re: Error resolving conref

Posted: Mon Feb 25, 2019 1:41 pm
by sorin_carbunaru
Hello,

Just wanted to update this thread to let you know that the conref resolving issue has been fixed in oXygen 21, which was released a few days ago.

All the best wishes,
Sorin Carbunaru
oXygen XML