Transform and translate content

Is this page helpful?
calendar icon
user iconJiri Lojda, Ondrej Chrastina
clock icon3 minutes
arrow-down-line iconDownload PDF
Let’s take a look at the approaches you can take to maintain the original structure of your rich text elements in the translated texts.
Rich text elements might contain images, linked items, components, and formatted text. You need to convert the rich text elements into a format that preserves the information about the position of linked items or images used in the rich text.Also, make sure to transform the translation unit into a format supported by your TMS, for example, JSON or XLIFF.

A. Insert placeholders in the rich text content

Insert placeholders that are not supposed to be translated into the text and then use the placeholders to insert the references back into the translated text.
➕ Advantages➖ Disadvantages
  • Easy to implement.
  • Content from the rich text element remains as one piece of text in the TMS.
Some translation management systems might not support placeholders in the text sent for translation.

B. Split the rich text using references

Split the rich text using references into text chunks and encode the references that should be between them as translation keys or metadata of those chunks.
➕ Advantages➖ Disadvantages
Doesn’t require special placeholders in the text.
  • More challenging to implement than placeholders.
  • The rich text element is split into multiple chunks, which might be more difficult to translate for the TMS, especially for human translators.
  • Develop with Kontent.ai
  • Manage API keys
  • Hello World
  • Hello Web Spotlight
  • Try sample apps
  • Build apps
  • Decide navigation and URLs
  • Environments
  • Get Developer Certification
For example, you can use a slight modification of XPath to encode a place of each text chunk in a JSON and use an empty string as a value for keys pointing to a reference.
  • desktop-alt icon
  • Cheat sheets
  • Documentation
  • API reference
  • Product updates
Kontent.ai Learn
  • Plan
  • Set up
  • Model
  • Develop
  • Create
  • Overview
  • Integrate search
  • Translation management systems
  • Automate content updates with webhooks
  • PDFs and other formats
Copyright © 2024 Kontent.aiarrow-right-top-square icon. All rights reserved.
  • Webarrow-right-top-square icon
  • Privacy policyarrow-right-top-square icon
  • Cookies policy
  • Consent settingsarrow-right-top-square icon
  • Securityarrow-right-top-square icon
  • GDPRarrow-right-top-square icon
  • Sign in
    • Content flow
    • Define triggers
    • Define translation units
    • Transform and translate
    • Read and import