Custom localizations for webhelp output in external framework

[mross]

I have Oxygen 23.1 installed at: C:\Program Files\Oxygen

The webhelp responsive plugin is at the install location: C:\Program Files\Oxygen\frameworks\dita\DITA-OT3.x\plugins\com.oxygenxml.webhelp.responsive

I have a custom framework with other extension files installed at: C:\dita_custom

I have a custom localization plugin at: C:\dita_custom\webhelp_resources\com.oxygenxml.webhelp.localization

How do I have the default webhelp responsive plugin packaged with Oxygen reach out to my extensions and include my localization customizations in com.oxygenxml.webhelp.localization?

[radu_pisoi]

Hi,

The WebHelp localization plugin should be installed in one of the DITA-OT plugins directory.

The default DITA-OT plugins directory is located in ${DITA-OT-DIR}/plugins, but you can add additional plugin
directories using the plugindirs property from ${DITA-OT-DIR}/config/configuration.properties.

Please see The configuration.properties file topic for more details.

[mross]

Making a path to an external framework directory still requires updating a configuration.properties file that is in the default toolkit in Oxygen. How can I make that setting when everybody installs Oxygen Author on their local client?

[alex_jitianu]

Hello,

You could distribute an entire DITA-OT, one that has the com.oxygenxml.webhelp.localization plugin already integrated. An Oxygen plugin can a special extension point to install such a custom DITA-OT in Oxygen. You can ship this as an Oxygen add-on. Please note that after the user installs the add-on, it needs to go to Options -> Preferences... on page DITA and change the DITA Open Toolkit option in the DITA preferences page.

Another option, if you are using Oxygen project file, is to put the DITA-OT in the project and set the DITA Open Toolkit option.

Best regards,
Alex