@conkeyref with @conref

Having trouble installing <oXygen/>? Got a bug to report? Post it all here.
juliov27
Posts: 4

@conkeyref with @conref

Mon Sep 25, 2017 10:44 pm

Hi,

According to the spec, if a @conkeyref cannot be resolved, a processor should look to the @conref attribute to resolve the reuse. If both are not resolvable, the processor SHOULD issue a warning. However, with oXygen 19 and whatever DITA-OT is bundled, this is not the case. I'm unsure where the issue resides, so I'm starting here to see if the problem is within the oXygen OT extensions or if this is a bug to be reported to the DITA-OT. Thanks.
Radu
Posts: 5088

Re: @conkeyref with @conref

Tue Sep 26, 2017 7:59 am

Hi Julio,

Discussing only about the DITA OT publishing part, I tested with DITA OT 2.5.2 and there are two cases:

1) The conkeyref is to a key which is not defined.
2) The conkeyref uses a defined key but points to an @id attribute which is not defined in the target topic.

For (1) the conref fallback seems to be taken into account. For (2) it is not taken into account.

The DITA 1.3 specification:

http://docs.oasis-open.org/dita/dita/v1.3/errata01/os/complete/part3-all-inclusive/langRef/attributes/theconkeyrefattribute.html#theconkeyrefattribute

seems to precisely describe the behavior for case (1):

When the key name specified by the @conkeyref attribute is not defined and the element also specifies a @conref attribute, the @conref attribute is used to determine the content reference relationship.


but it does not describe the behavior for case (2).
So I'm not sure what the behavior of the DITA OT should be in case (2).

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

Re: @conkeyref with @conref

Tue Sep 26, 2017 3:27 pm

Hi Radu,

I would expect that if the target id is also incorrect, that the processing should treat it the same as a broken key; the target isn't located so it would look to the @conref for resolution. I assume this discussion is out of scope for this forum. Is it something to bring up to the TC?
juliov27
Posts: 4

Re: @conkeyref with @conref

Tue Sep 26, 2017 3:29 pm

I forgot to mention. Based on what I saw, in case 2, the OT doesn't resolve the link at all so you get no output.
Radu
Posts: 5088

Re: @conkeyref with @conref

Tue Sep 26, 2017 3:33 pm

Hi Julio,

Yes, so first maybe you can ask the DITA TC about how a publishing engine should behave in (2). If they give a clear answer you could try to open an issue for it in the DITA OT issues list.

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

Return to “Common Problems”

Who is online

Users browsing this forum: No registered users and 0 guests