When do you need to re-import transformation scenarios?

KFriesen
Posts: 2

When do you need to re-import transformation scenarios?

Wed Jan 09, 2019 11:04 pm

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.
Radu
Posts: 5930

Re: When do you need to re-import transformation scenarios?

Thu Jan 10, 2019 11:24 am

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/20.1/ug-editor/topics/simple-dita-ot-plugin.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
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
KFriesen
Posts: 2

Re: When do you need to re-import transformation scenarios?

Thu Jan 10, 2019 5:59 pm

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
Radu
Posts: 5930

Re: When do you need to re-import transformation scenarios?

Fri Jan 11, 2019 9:12 am

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
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com

Return to “DITA (Editing and Publishing DITA Content)”

Who is online

Users browsing this forum: No registered users and 1 guest