DITA 1.3 Cross-Deliverable Links

kirkilj
Posts: 79
Joined: Fri May 14, 2010 12:14 am

DITA 1.3 Cross-Deliverable Links

Post by kirkilj » Wed Nov 14, 2018 6:32 pm

Does the OT built into Oxygen support cross-deliverable links? Does any processor support this capability? I understand the description in the Oxygen and DITA-OT documentation from a language spec perspective, but it's not clear if the processors have caught up to support it yet. I've seen messages in various maillists indicating that the functionality wasn't implemented in DITA-OT as of May, but have any processors have implemented the feature?

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

Re: DITA 1.3 Cross-Deliverable Links

Post by Radu » Wed Nov 14, 2018 11:14 pm

Hi John,

Cross publication linking is not yet implemented in the DITA OT:
https://github.com/dita-ot/dita-ot/issues/1768

so you will either need to link directly to the server location where the second publication is located or maybe perform some post processing of the published output to get the links right.

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

kirkilj
Posts: 79
Joined: Fri May 14, 2010 12:14 am

Re: DITA 1.3 Cross-Deliverable Links

Post by kirkilj » Fri Nov 16, 2018 3:34 pm

Thanks Radu. I was just checking to see if you had done something to extend OT via a plugin or two to implement a workaround.

kirkilj
Posts: 79
Joined: Fri May 14, 2010 12:14 am

Re: DITA 1.3 Cross-Deliverable Links

Post by kirkilj » Fri Nov 16, 2018 3:39 pm

I've heard it mentioned when the DITA 1.3 new features were being presented that this feature would be difficult for a processor to implement, but if the gen-list phase of DITA-OT retains a list of all the files in the target peer as well as the root map location of the target and source, couldn't an accurate keydef file be generated for the proper key-scope. I could be way off, I'm sure.

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

Re: DITA 1.3 Cross-Deliverable Links

Post by Radu » Mon Nov 19, 2018 10:37 am

Hi John,

I do not have a precise idea about how this could get implemented. Maybe you could get in touch with Eliot Kimber who proposed this feature in the DITA 1.3 specification, see what ideas he has about the implementation.

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

steinbacherGE
Posts: 12
Joined: Tue Mar 13, 2018 6:07 pm

Re: DITA 1.3 Cross-Deliverable Links

Post by steinbacherGE » Fri Aug 23, 2019 10:03 pm

Any update on how to make DITA cross-deliverable links work?

I've been trying to figure it out as described here:

https://www.oxygenxml.com/dita/1.3/spec ... -maps.html

I downloaded the cross-deliverable-links dita-test-case:

https://github.com/dita-community/dita- ... able-links

I noticed this test-case includes a project file (cross-deliverable-links-test.xpr) mentioned by Eliot Kimber:

https://github.com/dita-ot/dita-ot/issu ... -499543114

Is there a special way to make these links work using the project file?

I'm publishing to Oxygen Webhelp Responsvie (v20.1).

I tried to publish as-is, starting with maps A, B and C first. I got these errors when publishing test-01:

[DOTJ047I] Unable to find key definition for key reference "map-a.topic-01" in root scope. The href attribute may be used as fallback if it exists
[DOTJ047I] Unable to find key definition for key reference "map-b.topic-01" in root scope. The href attribute may be used as fallback if it exists
[DOTJ047I] Unable to find key definition for key reference "map-c.topic-01" in root scope. The href attribute may be used as fallback if it exists

Plus sever Missing navtitle and linktest errors.

Do I need to modify the project or the scoped keys based on my local file structure to make the links work?

I've attached a screenshot of my output.
cross-deliverable-links.png
cross-deliverable-links.png (33.4 KiB) Viewed 175 times
Thanks,

Leroy

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

Re: DITA 1.3 Cross-Deliverable Links

Post by Radu » Mon Aug 26, 2019 8:19 am

Hi,

Sorry but the DITA Open Toolkit has not yet implemented this feature. So in the meantime you will need to add web links pointing to the web server where the secondary publication will be placed.

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

Post Reply