Page 1 of 1

Add plugins in custom DITA OT to transformation scenarios

Posted: Sun Jan 10, 2021 10:17 am
by maglid
I notice that if I add a new plugin to the DITA OT that is under oxygen/frameworks/dita/DITA-OT3.x, its transform gets added to the GUI in Transformation Scenarios.

I often use external DITA OTs in Oxygen, is there a way for Oxygen to add the transforms from my external DITA OTs to be available in the GUI without manual adding them?

Thanks,
Mark

Re: Add plugins in custom DITA OT to transformation scenarios

Posted: Mon Jan 11, 2021 2:54 pm
by Radu
Hi Mark,

When you go to the "Configure Transformation Scenarios" dialog and click the "New" button to create a new transformation scenario, there is a dialog which shows up allowing you to pick the transtype for the new scenario. Oxygen populates transtype values in that dialog by auto detecting plugins in the DITA OT "plugins" folder (either in the bundled DITA OT or in your own DITA-OT):

https://www.oxygenxml.com/doc/versions/ ... ation.html

but Oxygen does not automatically create transformation scenarios based on those new transtypes, you need to create those yourself.

If you open Oxygen's "Configure Transformation Scenarios" dialog, indeed it contains there a list of predefined transformation scenarios. Those scenarios are not added there automatically by Oxygen by auto detecting plugin transtypes, they are created in the "DITA Map" framework configuration from the Oxygen Preferences->"Document Type Association" page.
So if you want to share with others transformation scenarios based on your new plugin transtype, you need to create the scenarios and then share them either at project level or exported:

https://www.oxygenxml.com/doc/versions/ ... aring.html

Or you can create a framework extension of the "DITA Map" framework configuration and share it with others.


Regards,
Radu

Re: Add plugins in custom DITA OT to transformation scenarios

Posted: Tue Jan 12, 2021 9:28 am
by maglid
Thanks Radu!

You are right, Oxygen will not place top-level transformation scenarios in my list for my custom plugins. But if I put my custom plugins into the bundled DITA OT and integrate them, then Oxygen will make them available under New > DITA OT Transformation, and all I have to do is pick them and add them. Then they are ready to publish.

For a separate DITA OT, for example of an older version that I need to maintain, based on your info I discovered that if in Oxygen I go to Options > Preferences > DITA and change the default DITA OT to my old OT, then Oxygen will make my transtypes available under New > DITA OT Transformation and I can just add them and they are ready to go.

Otherwise I have to create the new trans scenarios from scratch, defining the DITA OT, the transtypes, etc etc., which is what I did before your tip!

Thanks,
Mark

Re: Add plugins in custom DITA OT to transformation scenarios

Posted: Tue Jan 12, 2021 10:57 am
by Radu
Hi Mark,

Yes, it's much easier to switch the default DITA OT used by Oxygen instead of creating individual transformation scenarios which refer to it. And Oxygen detects parameters and transtypes from this default DITA OT set up in the Preferences->DITA page.

Regards,
Radu