New Localization Languages

Having trouble installing Oxygen XML WebHelp? Got a bug to report? Post it all here.
rpeck
Posts: 3
Joined: Wed Feb 26, 2025 1:01 am

New Localization Languages

Post by rpeck »

We are adding additional languages to our webhelp output.
For some reason, not all of the language strings in the localized file are getting picked up on publish.

Here is an example of our Italian translation.
The button to expand sections has the aria-label correct but the title is still in English.
<button class="webhelp_expand_collapse_sections" data-next-state="expanded" aria-label="Comprimi sezioni" title="Expand sections" style="display: block;"></button>

The print button is fine.
<button onclick="window.print()" title="Stampa questa pagina" aria-label="Stampa questa pagina" class="oxy-icon oxy-icon-print"></button>

On the search page, there no Italian phrases being substituted for their English equivalents.
Ex. The next and previous buttons still say "Next" and "Previous"

I have followed the instructions for adding a new languages as found on this page:
https://www.oxygenxml.com/doc/versions/ ... nsive.html

Is there something else i need to do besides the instructions listed on the page linked above?
Thank you!
marius
Posts: 52
Joined: Thu Mar 05, 2009 11:44 am

Re: New Localization Languages

Post by marius »

Hello,

We are not aware of any issues regarding the localization support in WebHelp output.
In order to assist you further, could you please send us your localization plugin? This will allow us to replicate the issue on our end and provide a more accurate solution.

Regards,
Marius
Marius Ciolacu
Syncro Soft / Oxygen XML
rpeck
Posts: 3
Joined: Wed Feb 26, 2025 1:01 am

Re: New Localization Languages

Post by rpeck »

I have attached the localization plugin.
com.oxygenxml.webhelp.localization.zip
You do not have the required permissions to view the files attached to this post.
marius
Posts: 52
Joined: Thu Mar 05, 2009 11:44 am

Re: New Localization Languages

Post by marius »

Hello,

I installed your plugin and it works fine for me. All the strings, including the ones that you pointed out are translated to Italian when I set the xml:lang="it-IT" on the ditamap root, or as a transformation parameter.
image.png
Please ensure you have accurately specified the correct xml:lang attribute, either within the ditamap or as a transformation parameter.

Regards,
Marius
You do not have the required permissions to view the files attached to this post.
Marius Ciolacu
Syncro Soft / Oxygen XML
rpeck
Posts: 3
Joined: Wed Feb 26, 2025 1:01 am

Re: New Localization Languages

Post by rpeck »

Hi Marius.
I figured out the issue.
I have both a localization plugin and an extension plugin for creating my own version of a sitemap.
In the plugins.xml file, there are 2 entries which require the com.oxygenxml.webhelp.responsive plugin.

Code: Select all

  <plugin id="com.ukg.oxygen.webhelp.custom.ant.extensions" version="0.0.0"
    xml:base="../plugins/com.ukg.oxygen.webhelp.custom.ant.extensions/plugin.xml">
    <require plugin="com.oxygenxml.webhelp.responsive"/>
    <feature extension="ant.import" file="custom_build_file.xml"/>
  </plugin>
  <plugin id="com.oxygenxml.webhelp.localization" version="0.0.0"
    xml:base="../plugins/com.oxygenxml.webhelp.localization/plugin.xml">
    <require plugin="com.oxygenxml.webhelp.responsive"/>
    <feature extension="dita.xsl.strings" file="webhelp-extension-strings.xml"/>
  </plugin>
In the createLocalizationFiles.xsl stylsheet, the code to copy the localization files looks for the localization plugin using the following XPATH:

Code: Select all

<xsl:variable name="xslStringsExtensionsFile"
                    select="$allPluginsDoc//plugin[require/@plugin = 'com.oxygenxml.webhelp.responsive'][1]/feature[@extension = 'dita.xsl.strings']/@file"/>
Using that xpath causes the first plugin element above to be returned which is the ant extension, not the localization plugin.
Therefore my strings file for additional languages does not load.

In order to get it to work, I changed the XPATH:

Code: Select all

 <xsl:variable name="xslStringsExtensionsFile"                   select="$allPluginsDoc//plugin[@id='com.oxygenxml.webhelp.localization']/feature[@extension = 'dita.xsl.strings']/@file"/>
Once I altered the XPATH, my strings loaded.
Can this be updated in a future release of the plugin?

Thank you for your help.
Rich
julien_lacour
Posts: 665
Joined: Wed Oct 16, 2019 3:47 pm

Re: New Localization Languages

Post by julien_lacour »

Hello,

We are aware of this issue and already implemented the modification in the XSLT stylesheet, in Oxygen 27.1 you shouldn't get this problem anymore.
I will post again here when the fix will be available.

Regards,
Julien
Post Reply