Page 1 of 1

Unable to add new language to WebHelp output (DOTX001W)

Posted: Tue May 03, 2016 1:26 pm
by 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).

Re: Unable to add new language to WebHelp output (DOTX001W)

Posted: Tue May 03, 2016 4:39 pm
by 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

Re: Unable to add new language to WebHelp output (DOTX001W)

Posted: Tue May 03, 2016 4:48 pm
by Anonymous1
Thanks for having a look at this.

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

Re: Unable to add new language to WebHelp output (DOTX001W)

Posted: Wed May 04, 2016 1:46 pm
by 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

Re: Unable to add new language to WebHelp output (DOTX001W)

Posted: Wed May 04, 2016 4:15 pm
by Anonymous1
That worked, thank you very much!

Re: Unable to add new language to WebHelp output (DOTX001W)

Posted: Thu Jun 01, 2017 3:26 pm
by 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

Re: Unable to add new language to WebHelp output (DOTX001W)

Posted: Thu Jun 01, 2017 4:21 pm
by 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

Re: Unable to add new language to WebHelp output (DOTX001W)

Posted: Thu Jun 08, 2017 12:54 pm
by DocWriter
Hi Ionela,

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

Re: Unable to add new language to WebHelp output (DOTX001W)

Posted: Tue Mar 27, 2018 3:52 pm
by hedyhan
DocWriter wrote: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?

Re: Unable to add new language to WebHelp output (DOTX001W)

Posted: Tue Mar 27, 2018 4:25 pm
by 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

Re: Unable to add new language to WebHelp output (DOTX001W)

Posted: Wed Mar 28, 2018 3:54 am
by 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?

Re: Unable to add new language to WebHelp output (DOTX001W)

Posted: Wed Mar 28, 2018 12:15 pm
by 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