Oxygen XML Forum

Hello,

My team uses custom DITA-OT plugins for PDF, Webhelp and htmlhelp. The plugins are imported in oXygen as global transformation scenarios. When a change is made to one of these plugins, is it always best practice to delete the transformation scenario, run the DITA OT integrator again, and then re-import the scenario? Or depending on the plugin change (small string or CSS change for example), can these steps sometimes skipped?

The reason I'm asking is because some people on my team duplicate the imported scenarios for several of their deliverables. It would be nice if they didn't have to delete all of their scenarios each time a tiny change is made to the plugin.

If anyone has any insight to this, please let me know.

Hi,

The plugins are imported in oXygen as global transformation scenarios.

Plugins are not transformation scenarios. A transformation scenario runs the DITA Open Toolkit publishing engine stating that a certain output type needs to be obtained.
A general description of a DITA OT plugin and how it can be installed is listed here:

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

Once a plugin's internal resources are changed you need to run from Oxygen the "Run DITA-OT Integrator" transformation scenario.
But transformation scenarios should not be deleted and re-imported every time you make modifications and re-integrate a plugin.

Regards,
Radu

Hi Radu,

Thanks for this explanation. So, after any update is made to the plugins, we just need to run the "Run DITA-OT Integrator" transformation scenario.

Thanks a lot,
Katelyn

Hi Katelyn,

Right, the only (very rare and improbable) instance in which you would need to modify the transformation scenarios would be the case when in the plugin.xml you would rename the "transtype" (format of the transformation) to be some other value because the transformation scenario has a reference to it.

Regards,
Radu