Unclear where and how this can be used in the API about azure-docs HOT 5 CLOSED

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.

from azure-docs.

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

from azure-docs.

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

from azure-docs.

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?

from azure-docs.

#please-close

from azure-docs.