Adding dita4publishers plugins

[pbw]

I wish to add the current set (0.9.16) of plugins to the oxygen DITA-OT toolkit at <OXYGEN_HOME>/frameworks/dita/DITA-OT/plugins.

Some of the plugins are already installed. I have added the others to the directory and run

Code: Select all

ant -f integrator.xml

from the DITA-OT directory. It all seemed to work.

However, I note that there are caveats on installing a new release of DITA-OT. Are there likely to be any problems in the approach I have taken? Is there anything I should watch for?

Peter

[Radu]

Hi Peter,

Every new Oxygen version comes with a bundled DITA OT and by default the DITA transformation scenarios use that bundled version of DITA OT to publish DITA to various output formats.

If you make modifications to the bundled DITA OT then if a new installation of Oxygen is made in the same directory you will lose all your changes as the DITA OT will be overwritten by the installation.
If the new installation of Oxygen is made in a separate folder then you will either have to repeat the changes to the new bundled DITA OT or make the transformation scenarios point to the DITA OT directory from the older installation.

Usually my suggestions in such cases in which customizations must be made inside the bundled DITA OT is to copy the bundled DITA OT outside of the Oxygen installation folder, make the modifications there and use that copy to run transformation scenarios instead of the bundled DITA OT. In this way you will be able to change Oxygen versions but keep the same DITA OT directory. If you are using a version system like SVN or CVS you can commit that copy of the custom DITA OT on the remote server and thus everybody else will use the custom DITA OT copy. You can also save transformation scenarios at project level and commit them to the SVN/CVS, thus everybody in the team will use the same transformation scenarios.

You can find more informations here:

http://www.oxygenxml.com/forum/post1824 ... vel#p18241

Regards,
Radu

[pbw]

Thanks Radu. After I had made the changes, I struck an odd problem, which I will document in another message.