Unable to add new language to WebHelp output (DOTX001W)

Having trouble installing <oXygen/>? Got a bug to report? Post it all here.
B-E-N
Posts: 94

Unable to add new language to WebHelp output (DOTX001W)

Tue May 03, 2016 1:26 pm

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
Posts: 195

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

Tue May 03, 2016 4:39 pm

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
Bogdan Cercelaru
<oXygen/> XML Editor, Schema Editor and XSLT Editor/Debugger
http://www.oxygenxml.com
B-E-N
Posts: 94

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

Tue May 03, 2016 4:48 pm

Thanks for having a look at this.

We are using DITA-OT 2.x and Oxygen 17.1
Radu
Posts: 5207

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

Wed May 04, 2016 1:46 pm

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
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
B-E-N
Posts: 94

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

Wed May 04, 2016 4:15 pm

That worked, thank you very much!
DocWriter
Posts: 6

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

Thu Jun 01, 2017 3:26 pm

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
Posts: 149

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

Thu Jun 01, 2017 4:21 pm

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/19.0/ug-editor/topics/localize-webhelp-x-publishing2.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
Ionela Istodor
oXygen XML Editor and Author Support
DocWriter
Posts: 6

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

Thu Jun 08, 2017 12:54 pm

Hi Ionela,

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

Return to “Common Problems”

Who is online

Users browsing this forum: No registered users and 2 guests