Teaching DITA new protocols for links

[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

[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

[Frank Ralf]

Hi Radu,
Thanks for the quick reply and the workaround. Will try that

Kind regards,
Frank

[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

[Frank Ralf]

Thanks for the pointer, Radu. I will give it a try.

Frank

[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