Unclear where and how this can be used in the API

[Paul-Dempsey]

• Exactly where in the request do you supply this? Is this simply embedded in the source text somewhere?

• What do you mean by "HTML mode"? Do you mean when an API request includes <ContentType>text/html</ContentType> (and maybe text/xml)?

Can you give an example using the API?

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: be0a7128-2576-678c-be8e-6f26fe9c1628
• Version Independent ID: c2575811-47ea-a584-c918-cd0a3df9189b
• Content
• Content Source
• Service: cognitive-services

[Paul-Dempsey]

After re-reading several times, I think I decoded what this was trying to say is that you apply the markup to the word or phrase for which you want to provide a fixed translation. This is somewhat parallel to the mechanism for "Do not translate": <div class="notranslate">untranslatable-text</div>, which unfortunately, and inconsistently, is apparently only usable in text/html and text/xml.

[amanarneja]

@Paul-Dempsey Thanks for the feedback! I have assigned this issue to the author who can work on making the content easier to understand.

[clayms]

Is there any movement on this? I am using python and submitting a json in a similar way to this example.

[clayms]

Combining the instructions here with the python examples with the following input

text = "Instant dictionary: word <mstrans:dictionary translation=\"wordomatic\">word or phrase</mstrans:dictionary> is a dictionary entry."

gives the following output:

[
    {
        "translations": [
            {
                "text": "Instant Dictionary Word wordomatic ist ein Wörterbucheintrag.",
                "to": "de"
            }
        ]
    }
]

Somehow everything before the tagged word is not translated.

However, translating text = "Instant dictionary: word" returns:
{"translations": [{"text": "Instant Dictionary: Word","to": "de"}]}

Whereas translating text = "Instant dictionary word" returns:
{"translations": [{"text": "Instant Wörterbuchwort","to": "de"}]}

What is the problem with "word" and ":" ?

How do these words and characters change the way the translation API works?

Why are these words and characters used in an example?

[tchristiani]

#please-close