Custom localizations for webhelp output in external framework

<oXygen/> general issues.
mross
Posts: 14
Joined: Wed Oct 03, 2018 10:36 pm

Custom localizations for webhelp output in external framework

Post by mross » Fri Jun 11, 2021 4:19 pm

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
Posts: 389
Joined: Thu Aug 21, 2003 11:36 am
Location: Craiova
Contact:

Re: Custom localizations for webhelp output in external framework

Post by radu_pisoi » Wed Jun 16, 2021 9:17 am

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.
Radu Pisoi
<oXygen/> XML Editor, Schema Editor and XSLT Editor/Debugger
http://www.oxygenxml.com

mross
Posts: 14
Joined: Wed Oct 03, 2018 10:36 pm

Re: Custom localizations for webhelp output in external framework

Post by mross » Thu Jul 22, 2021 8:07 pm

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
Posts: 851
Joined: Wed Nov 16, 2005 11:11 am

Re: Custom localizations for webhelp output in external framework

Post by alex_jitianu » Tue Jul 27, 2021 10:43 am

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

Post Reply