Translation Feature doesn't work normally

Report · Oct 05, 2021

I am using the latest version of RH. I tried to use the built-in functionality for documentation localization and, without surprise, once again made sure that it did not work properly.

При импорте xliff файлов большая часть переведенного текста пропадает и не может быть найдена в переведенных документах.

Report · Oct 05, 2021

When importing xliff files, most of the translated text disappears and cannot be found in translated documents.

Report · Oct 05, 2021

To exlude that the XLIFF file was not completely or not correctly translated, you can open the translated XLIFF file in a simple text editor like Notepadd++ and scroll to the end. There you will find the translation units.

If the CAT tool the translator is using works correctly (or is configured correctly), than all <trans-units> should have a source element, the <seg-source> element with all the source language segments (<mrk> elements), and the <target> element with all the corresponding <mrk> elements with the translations.

It looks like this (simplified for better readability):

<trans-unit id= "1">
    <source>This is the first sentence. This is the second sentence.</source>
    <seg-source>
        <mrk mtype="seg" mid="1">This is the first sentence.</mrk>
        <mrk mtype="seg" mid="2">This is the second sentence.</mrk>
    </seg-source>
    <target>
        <mrk mtype="seg" mid="1">Это первое предложение.</mrk>
        <mrk mtype="seg" mid="2">Это второе предложение.</mrk>
    </target>
</trans-unit>

Can you please check this and post a screenshot or te code from your translated XLIFF file?

Report · Oct 05, 2021

Report · Oct 05, 2021

@AndreyGl, Thanks for the screenshot. However, I did not mean a screenshot of RoboHelp, but from the source code of the translated XLIFF file. Alternatively, you can copy a small snippet from the translated XLIFF file and paste it here.

Here's how to do it in a few simple steps:
1. open Windows "Editor" (aka "Notepad") or any other plain text editor.
2. open the *.xlf file in it.
3. search for <body>.
4. mark an exemplary translation unit, i.e. <trans-unit> to </trans-unit>. Copy it and paste it here in a post. It should look like the one in my post from earlier.

Then we can see how the XLIFF file was translated, and infer what went wrong with the translation.

Russian:

Спасибо за скриншот. Однако я имел в виду скриншот не из RoboHelp, а из исходного кода переведенного XLIFF-файла. Как вариант, вы можете скопировать небольшой фрагмент из переведенного XLIFF-файла и вставить его сюда.

Вот как это сделать в несколько простых шагов:

откройте "Редактор" Windows (он же "Блокнот") или любой другой обычный текстовый редактор.
откройте в нем файл *.xlf.
найдите <body>.
выделите примерный блок перевода, т.е. от <trans-unit> до </trans-unit>. Скопируйте его и вставьте сюда в сообщение. Он должен выглядеть так же, как в моем предыдущем сообщении.

Тогда мы сможем увидеть, как был переведен XLIFF-файл, и сделать вывод о том, что пошло не так при переводе.

Report · Oct 05, 2021

I try to upload the code here for the third time, but it gets deleted. This is how it looks to me right after loading.

<?xml version="1.0" encoding="UTF-8"?>
<xliff xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="urn:oasis:names:tc:xliff:document:1.2 xliff-core-1.2-transitional.xsd" xmlns="urn:oasis:names:tc:xliff:document:1.2" version="1.2">
<file original="contents/First_Topic.htm" datatype="plaintext" source-language="ru-RU" target-language="en-US">
<header>
<projectid>b5434970-4d27-4080-a6dc-673ed1ac1d7e</projectid>

<reference>
<internal-file form="base64">PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4KPCFET0NUWVBFIGh0bWw+CjxodG1sIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5L3hodG1sIj4gICAgICAgICAKICA8aGVhZD4gICAgICAgICAgICAgICAKICAgIDxtZXRhIGh0dHAtZXF1aXY9IkNvbnRlbnQtVHlwZSIgY29udGVudD0idGV4dC9odG1sOyBjaGFyc2V0PXV0Zi04Ii8+CiAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICA8dGl0bGU+0J/QtdGA0LLQsNGPINGC0LXQvNCwPC90aXRsZT4KICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgIDxtZXRhIG5hbWU9InRvcGljLXN0YXR1cyIgY29udGVudD0iRHJhZnQiLz4KICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgIDxtZXRhIG5hbWU9ImdlbmVyYXRvciIgY29udGVudD0iQWRvYmUgUm9ib0hlbHAiLz4KICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgIDxsaW5rIHJlbD0ic3R5bGVzaGVldCIgaHJlZj0iYXNzZXRzL2Nzcy9kZWZhdWx0LmNzcyIgdHlwZT0idGV4dC9jc3MiLz4KICAgICAgICAgICAgICA8L2hlYWQ+CiAgICAgICAgICAgICAgCiAgPGJvZHk+ICAgICAgICAgICAgICAgCiAgICA8cCB0cmFuc2l0aW9uLW5vZGU9InRydWUiPiA8L3A+CiAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICA8aDE+0J/QtdGA0LLQsNGPINGC0LXQvNCwPC9oMT4KICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgIDxwIHRyYW5zaXRpb24tbm9kZT0idHJ1ZSI+IDwvcD4KICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgIDxwPtCt0YLQviDQv9C10YDQstCw0Y8g0YLQtdC80LAg0LLQsNGI0LXQs9C+INC/0YDQvtC10LrRgtCwLiDQo9C00LDQu9C40YLQtSDRjdGC0L7RgiDRgtC10LrRgdGCINC4INC30LDQvNC10L3QuNGC0LUg0LXQs9C+INGB0LLQvtC40LwuINCn0YLQvtCx0Ysg0LTQvtCx0LDQstC40YLRjCDQvdC+0LLRg9GOINGC0LXQvNGDLCDQvdCw0LbQvNC40YLQtSDQutC90L7Qv9C60YMgPGI+0KHQvtC30LTQsNGC0Ywg0YLQtdC80YM8L2I+INC90LAg0L/QsNC90LXQu9C4INC40L3RgdGC0YDRg9C80LXQvdGC0L7Qsi48L3A+CiAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICA8cCB0cmFuc2l0aW9uLW5vZGU9InRydWUiPiA8L3A+CiAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICA8cD7CoDwvcD4KICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgIDxwIHRyYW5zaXRpb24tbm9kZT0idHJ1ZSI+IDwvcD4KICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgIDxwPtCn0YLQvtCx0Ysg0YPQt9C90LDRgtGMINCx0L7Qu9GM0YjQtSDQviDRgNC10LTQsNC60YLQvtGA0LUsINC90LDQttC80LjRgtC1INC60LvQsNCy0LjRiNGDIDxiPkYxPC9iPiAo0LrRg9GA0YHQvtGAINC00L7Qu9C20LXQvSDQvdCw0YXQvtC00LjRgtGM0YHRjyDQvdCwINGN0YLQvtC5INC/0LDQvdC10LvQuCkg0Lgg0L7Qt9C90LDQutC+0LzRjNGC0LXRgdGMINGBINGB0L7QvtGC0LLQtdGC0YHRgtCy0YPRjtGJ0LjQvCDRgNCw0LfQtNC10LvQvtC8INGB0L/RgNCw0LLQutC4LjwvcD4KICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgIDxwIHRyYW5zaXRpb24tbm9kZT0idHJ1ZSI+IDwvcD4KICAgICAgICAgICAgICA8L2JvZHk+CjwvaHRtbD4=</internal-file>
</reference>

<tool tool-id="6" tool-name="Adobe RoboHelp" />
</header>

<body>
<group restype="x-document-xhtml5" resname="RoboHelp Document">
<group id="/html[1]" resname="Html">
<group id="/html[1]/head[1]" resname="Head">
<trans-unit id="/html[1]/head[1]/title[1]" resname="Title">
<source xml:lang="ru-RU">
Первая тема
</source><target state="new">

</target>

</trans-unit>
</group>
<group id="/html[1]/body[1]" resname="Body">
<trans-unit id="/html[1]/body[1]/h1[1]" resname="Heading 1">
<source xml:lang="ru-RU">
Первая тема
</source><target state="new">

</target>

</trans-unit>
<trans-unit id="/html[1]/body[1]/p[3]" resname="Paragraph">
<source xml:lang="ru-RU">
Это первая тема вашего проекта.
Удалите этот текст и замените его своим.
Чтобы добавить новую тему, нажмите кнопку <g id="/html[1]/body[1]/p[3]/b[1]/" equiv-text="b" ctype="bold">Создать тему</g> на панели инструментов.
</source><target state="new">

</target>

</trans-unit>
<trans-unit id="/html[1]/body[1]/p[7]" resname="Paragraph">
<source xml:lang="ru-RU">
Чтобы узнать больше о редакторе, нажмите клавишу <g id="/html[1]/body[1]/p[7]/b[1]/" equiv-text="b" ctype="bold">F1</g> (курсор должен находиться на этой панели) и ознакомьтесь с соответствующим разделом справки.
</source><target state="new">

</target>

</trans-unit>
</group>
</group>
</group>
</body>
</file>
</xliff>

Report · Oct 05, 2021

Have you confirmed that you're doing this process correctly? I don't deal with localization, but don't recall anyone reporting that something wasn't working with it.

Report · Oct 05, 2021

There are more things in heaven and earth, Horatio,

Than are dreamt of in your philosophy.

Report · Oct 05, 2021

Please clarify what you mean by "latest version". Sometimes people believe that to be true but we then find it isn't. You should be on 2020..6.

See Manual Translation. Are you saying the process is going wrong at that stage? Like @Jeff_Coatsworth I don't work with translation but the most likely cause at that stage would be something wrong with the XLIFF file.

I think on this one, unless someone familiar with translation steps in, your best bet would be Support. See https://helpx.adobe.com/contact/enterprise-support.other.html#robohelp for your Adobe Support options. The email link tcssup@adobe.com is recommended as it reaches a team dedicated to Technical Communication Suite products including RoboHelp.

________________________________________________________
See www.grainge.org for free Authoring and RoboHelp Information

Help others by clicking Correct Answer if the question is answered. Found the answer elsewhere? Share it here. "Upvote" is for useful posts.

Report · Oct 05, 2021

Hello Peter,

The versionof my RH is 2020.6.76.

Trust me that when I write here all the manuals have already been read and many hours have been spent on various tests and trying to solve the problem on my own.

Unfortunately there is no support from technical support.

Report · Oct 05, 2021

Dear @AndreyGl, the support team and I are there to help you. You can always directly reach out to tcssup@adobe.com to connect with the Adobe Technical Communication Support team wich is specialized on RoboHelp and FrameMaker. Generally said, the more information and examples you can provide here or with the support team, the more likely we can find a solution for you.

Уважаемый Андрей,

мы с командой поддержки готовы помочь вам. Вы всегда можете напрямую обратиться по адресу tcssup@adobe.com, чтобы связаться с командой поддержки Adobe Technical Communication Support, которая специализируется на RoboHelp и FrameMaker. Как правило, чем больше информации и примеров вы сможете предоставить здесь или в службу поддержки, тем больше вероятность того, что мы сможем найти для вас решение.

Report · Oct 05, 2021

You can find my today appeal on this subject in this mailbox.

Report · Oct 05, 2021

Where? What mailbox? If you mean this thread, this is mostly a user to user forum, not Support. On this occasion you are fortunate that Stefan has stepped in.

________________________________________________________
See www.grainge.org for free Authoring and RoboHelp Information

Help others by clicking Correct Answer if the question is answered. Found the answer elsewhere? Share it here. "Upvote" is for useful posts.

Report · Oct 05, 2021

The one listed on the official site [tcssup@adobe.com] and that you warmly recommended to me.
[image removed by moderator to protect private info]

Report · Oct 05, 2021

You can find my today appeal on this subject in this mailbox.

Only Adobe staff can see that.

________________________________________________________
See www.grainge.org for free Authoring and RoboHelp Information

Help others by clicking Correct Answer if the question is answered. Found the answer elsewhere? Share it here. "Upvote" is for useful posts.

Report · Oct 05, 2021

@Stefan Gentz is an Adobe employee! He has a depth of knowledge in things like this.

I have just heard from someone saying quite the opposite of what you say about Support and I recently had to use them and found the same. How did you contact them?

________________________________________________________
See www.grainge.org for free Authoring and RoboHelp Information

Help others by clicking Correct Answer if the question is answered. Found the answer elsewhere? Share it here. "Upvote" is for useful posts.

Report · Oct 05, 2021

It seems to me that this is not the case when rumors should be believed. Facts are stubborn.

I have personal statistics of requests and it doesn't give any hope.

By today I have probably used all possible communication methods.

Report · Oct 05, 2021

I am quoting facts, not rumours. I can't help you further on this one.

________________________________________________________
See www.grainge.org for free Authoring and RoboHelp Information

Help others by clicking Correct Answer if the question is answered. Found the answer elsewhere? Share it here. "Upvote" is for useful posts.

Report · Oct 05, 2021

Psst, @AndreyGl, that's not a screenshot of your XLIFF file like @Stefan Gentz asked you to check. Try again to check what he's looking for.

Report · Oct 05, 2021

Plobably like this

Report · Oct 05, 2021

Yes, like this. Just please do not paste the whole XLIFF file content here. Just an example of one <trans-unit> 🙂

Report · Oct 05, 2021

But unfortunately, my reply disappeared, as well as part of the translated text.

Report · Oct 05, 2021

Here is body of my xliff:

 <body>
      <group restype="x-document-xhtml5" resname="RoboHelp Document">
        <group id="/html[1]" resname="Html">
          <group id="/html[1]/head[1]" resname="Head">
            <trans-unit id="/html[1]/head[1]/title[1]" resname="Title">
              <source xml:lang="ru-RU">
                Первая тема
              </source><target state="new">
                
              </target>
              
            </trans-unit>
          </group>
          <group id="/html[1]/body[1]" resname="Body">
            <trans-unit id="/html[1]/body[1]/h1[1]" resname="Heading 1">
              <source xml:lang="ru-RU">
                Первая тема
              </source><target state="new">
                
              </target>
              
            </trans-unit>
            <trans-unit id="/html[1]/body[1]/p[3]" resname="Paragraph">
              <source xml:lang="ru-RU">
                Это первая тема вашего проекта.
                Удалите этот текст и замените его своим.
                Чтобы добавить новую тему, нажмите кнопку <g id="/html[1]/body[1]/p[3]/b[1]/" equiv-text="b" ctype="bold">Создать тему</g> на панели инструментов.
              </source><target state="new">
                
                
                
              </target>
              
            </trans-unit>
            <trans-unit id="/html[1]/body[1]/p[7]" resname="Paragraph">
              <source xml:lang="ru-RU">
                Чтобы узнать больше о редакторе, нажмите клавишу <g id="/html[1]/body[1]/p[7]/b[1]/" equiv-text="b" ctype="bold">F1</g> (курсор должен находиться на этой панели) и ознакомьтесь с соответствующим разделом справки.
              </source><target state="new">
                
              </target>
              
            </trans-unit>
          </group>
        </group>
      </group>
    </body>

Report · Oct 05, 2021

and after translation

<body>
<group restype="x-document-xhtml5" resname="RoboHelp Document">
<group id="/html[1]" resname="Html">
<group id="/html[1]/head[1]" resname="Head">
<trans-unit id="/html[1]/head[1]/title[1]" resname="Title">
<source xml:lang="ru-RU">
Первая тема
</source><target state="translated">
First topic
</target>

</trans-unit>
</group>
<group id="/html[1]/body[1]" resname="Body">
<trans-unit id="/html[1]/body[1]/h1[1]" resname="Heading 1">
<source xml:lang="ru-RU">
Первая тема
</source><target state="translated">
First topic
</target>

</trans-unit>
<trans-unit id="/html[1]/body[1]/p[3]" resname="Paragraph">
<source xml:lang="ru-RU">
Это первая тема вашего проекта.
Удалите этот текст и замените его своим.
Чтобы добавить новую тему, нажмите кнопку <g id="/html[1]/body[1]/p[3]/b[1]/" equiv-text="b" ctype="bold">Создать тему</g> на панели инструментов.
</source><target state="translated">
This is the first topic of your project.
Delete this text and replace it with your own.
To add a new topic, click the <g id="/html[1]/body[1]/p[3]/b[1]/" equiv-text="b" ctype="bold">New Topic</g> button on the toolbar.
</target>

</trans-unit>
<trans-unit id="/html[1]/body[1]/p[7]" resname="Paragraph">
<source xml:lang="ru-RU">
Чтобы узнать больше о редакторе, нажмите клавишу <g id="/html[1]/body[1]/p[7]/b[1]/" equiv-text="b" ctype="bold">F1</g> (курсор должен находиться на этой панели) и ознакомьтесь с соответствующим разделом справки.
</source><target state="translated">
To learn more about the editor, press <g id="/html[1]/body[1]/p[7]/b[1]/" equiv-text="b" ctype="bold">F1</g> (the cursor should be on this pane) and see the related Help topic.
</target>

</trans-unit>
</group>
</group>
</group>
</body>

Report · Oct 05, 2021

Okay, but even the translated XLIFF file is broken.

In your file it looks like this:

<trans-unit id="/html[1]/head[1]/title[1]" resname="Title">
  <source xml:lang="ru-RU">Первая тема</source>
  <target state="translated">First topic</target>
</trans-unit>

But it would need to look like this:

<trans-unit id="/html[1]/head[1]/title[1]" resname="Title">
  <source xml:lang="ru-RU">Первая тема</source>
  <seg-source>
    <mrk mtype="seg" mid="1">RoboHelp Test Document</mrk>
  </seg-source>
  <target state="translated">
    <mrk mtype="seg" mid="1">First topic</mrk>
  </target>
</trans-unit>

Translation Feature doesn't work normally

2 Correct answers