Unable to add new language to WebHelp output (DOTX001W)

[Anonymous1]

Hello,

I am trying to figure out how to add our new language (russian) to the webhelp output.

When I run the webhelp transformation scenario, I get the following message:

[DOTX001W]: No string named 'linkToThis' was found for language 'ru-ru'. Using the default language 'en-us'. Add the mapping between default language and specific language for the string 'linkToThis'.

Here is what I did.

1. Went to DITA-OT\plugins\com.oxygenxml.webhelp\oxygen-webhelp\resources\localization and created the file strings-ru-ru.xml (copied the english file and renamed it).
2. Opened strings-ru-ru.xml and changed <strings xml:lang="en-us"> to <strings xml:lang="ru-ru">.
3. Opened the strings.xml file and added the following at the end of the list:

<lang xml:lang="ru" filename="strings-ru-ru.xml"/>
<lang xml:lang="ru-ru" filename="strings-ru-ru.xml"/>

4. Set the xml:lang attribute of each topic and ditamap to ru-RU.

But that doesn't seem to be enough. What am I missing?

I tried to follow this:
https://www.oxygenxml.com/doc/versions/ ... elp-1.html

What I don't think is necessary (tried it anyway) was to set args.default.language to ru-ru. Normally, the xml:lang attribute should be enough. Everything works fine when I output some of the existing languages (fr-fr for example).

[bogdan_cercelaru]

Hello,

Thank you for reporting this.
What version of DITA-OT are you using? I was able to obtain this kind of message only if I am using DITA-OT 2.x to generate WebHelp.

I've also registered an issue in our issue tracking system to be analyzed.

Regards,
Bogdan

[Anonymous1]

Thanks for having a look at this.

We are using DITA-OT 2.x and Oxygen 17.1

[Radu]

Hi Ben,

After step (4) you should also try running the DITA Open Toolkit Integrator task, there should be a predefined Oxygen transformation scenario called Run DITA OT Integrator in the Transformation Scenarios view which you can use for this. The integrator will add your extra translations to the set of translations the DITA OT XHTML-based publishing can use.

Regards,
Radu

[Anonymous1]

That worked, thank you very much!

[DocWriter]

Hello,
I've tried the procedure like mentioned above in Oxygen 19, but still get no translations in Webhelp Responsive.
What am I missing?
Regards,
Stefaan

[ionela]

Hi Stefaan,

The complete procedure to localize the static labels that are used in WebHelp output is described in our user-manual:
https://www.oxygenxml.com/doc/versions/ ... hing2.html

In short, you should:

1. Create a new string-X-X.xml file (e.g. for Canadian French the file should be something like this string-fr-ca.xml).
   If the language file does not exist, when you create it you can start from strings-en-us.xml (duplicate strings-en-us.xml and then rename the copy to string-X-X.xml).
2. Make sure you add newly created XML file in strings.xml. For Canadian French it should be added like this:

   Code: Select all

   <lang xml:lang="fr-ca" filename="strings-fr-ca.xml"/>

3. Run the predefined transformation scenario called Run DITA OT Integrator by executing it from the Apply Transformation Scenario(s) dialog box. If the integrator is not visible, select the Show all scenarios option that is available in the Settings drop-down menu.
   Note that you need to run oXygen with administrative rights when you run the Integrator. After the transformation is successfully executed we recommend to restart oXygen with normal privileges.
4. Edit the DITA Map WebHelp Responsive transformation scenario and set the args.default.language parameter to that language code (fr-ca for Canadian French).
5. Run the edited DITA Map WebHelp Responsive transformation scenario.

I hope this helps.

Regards,
Ionela

[DocWriter]

Hi Ionela,

problem solved.
I did something wrong in step 2.
Thanks,
Stefaan

[hedyhan]

Hello,
I've tried the procedure like mentioned above in Oxygen 19, but still get no translations in Webhelp Responsive.
What am I missing?
Regards,
Stefaan

I also still get no translations in Webhelp Responsive, what can I do?

[ionela]

Hello,

What version of oXygen XML do you currently use? Please make sure have followed the entire procedure specified two steps above.
Note that you need to run oXygen with administrative rights when you run DITA OT Integrator.

Regards,
Ionela

[hedyhan]

I use the oxygen version 19.
After I set the the args.default.language parameter to my language code, the warning message changes to :

"[DOTX052W]: No string named ' printThisPage ' was found when creating generated text; using the value ' printThisPage ' in your output file"


What can I do next?

[cosmin_andrei]

Hello,

This is indeed a known issue in v19 and has already been resolved in v19.1, so you can simply update to this version to avoid the issue:
https://www.oxygenxml.com/xml_editor/so ... ditor.html