Page 1 of 1

Teaching DITA new protocols for links

Posted: Wed Jun 11, 2014 6:22 pm
by Frank Ralf
Hi,

We want to link to external DOORS (requirement management system) resources from DITA files. The links look like this:

Code: Select all

doors://inc4209.server.de-hxg01.domain.com:36677/?version=2&prodID=0&urn=urn:telelogic::1-455c3682813a957b-M-00013f00
Trying to create an <xref> doesn't work, because the "doors:" protocol is unknown to DITA. Is there a way to teach DITA this (and other) protocol?

TIA
Frank

Re: Teaching DITA new protocols for links

Posted: Thu Jun 12, 2014 10:31 am
by Radu
Hi Frank,

We'll try to relax the conditions imposed by Oxygen when users want to insert a link with a protocol Oxygen does not know about.
In the meantime in the Oxygen Preferences->"Editor / Templates / Code Templates" page you could define a new code template with the following content:

Code: Select all

<xref href="${ask('Paste Link Here:', generic, '')}" format="html" scope="external"/>
When you press ENTER in the Author visual editing mode the code template will appear in the proposals list. The down side is that you will need to escape your &'s to &'s before the insertion.

You could also create a new Author action in the DITA document type association for inserting your own special links using again the $ask editor variable.

Regards,
Radu

Re: Teaching DITA new protocols for links

Posted: Thu Jun 12, 2014 12:29 pm
by Frank Ralf
Hi Radu,
Thanks for the quick reply and the workaround. Will try that ;-)

Kind regards,
Frank

Re: Teaching DITA new protocols for links

Posted: Wed Apr 01, 2015 9:35 am
by Radu
Hi,

Just to update this thread, Oxygen 16.1 has a more relaxed behavior when inserting web links to URLs for which the protocols are not known by the application.

Regards,
Radu

Re: Teaching DITA new protocols for links

Posted: Wed Apr 01, 2015 11:33 am
by Frank Ralf
Thanks for the pointer, Radu. I will give it a try.

Frank

Re: Teaching DITA new protocols for links

Posted: Mon May 18, 2015 6:51 pm
by Frank Ralf
Hi Radu,

Great, the following link is now valid in oXygen 16.1.

Code: Select all

<xref href="doors://inc4309.server.de-hxg01.domain.com:36577/?version=2&prodID=0&urn=urn:telelogic::1-455c3682813a957b-M-00013f00" format="doors" scope="external" />
Frank