When do you need to re-import transformation scenarios?
Post here questions and problems related to editing and publishing DITA content.
When do you need to re-import transformation scenarios?
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.
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.
Re: When do you need to re-import transformation scenarios?
Hi,
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
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.The plugins are imported in oXygen as global transformation scenarios.
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
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
<oXygen/> XML Editor
http://www.oxygenxml.com
Re: When do you need to re-import transformation scenarios?
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
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
Re: When do you need to re-import transformation scenarios?
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
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
<oXygen/> XML Editor
http://www.oxygenxml.com
Return to “DITA (Editing and Publishing DITA Content)”
Jump to
- Oxygen XML Editor/Author/Developer
- ↳ Feature Request
- ↳ Common Problems
- ↳ DITA (Editing and Publishing DITA Content)
- ↳ SDK-API, Frameworks - Document Types
- ↳ DocBook
- ↳ TEI
- ↳ XHTML
- ↳ Other Issues
- Oxygen XML Web Author
- ↳ Feature Request
- ↳ Common Problems
- Oxygen Content Fusion
- ↳ Feature Request
- ↳ Common Problems
- Oxygen JSON Editor
- ↳ Feature Request
- ↳ Common Problems
- Oxygen PDF Chemistry
- ↳ Feature Request
- ↳ Common Problems
- Oxygen Feedback
- ↳ Feature Request
- ↳ Common Problems
- Oxygen XML WebHelp
- ↳ Feature Request
- ↳ Common Problems
- XML
- ↳ General XML Questions
- ↳ XSLT and FOP
- ↳ XML Schemas
- ↳ XQuery
- NVDL
- ↳ General NVDL Issues
- ↳ oNVDL Related Issues
- XML Services Market
- ↳ Offer a Service