Documentation Center

Translation

You can enable translation and specify languages to which documents are to be translated when creating objects. This is done using a combination of Content Manager metadata fields for the objects. You can specify a fallback language (if a translation is not available) when you create the publication.

The <languagepath> element defines the source language - target language combination that is allowed in the system. For the example above English is the source language.
The number of parents from which an object inherits language is also configured in the parameter MaxInheritedLanguageDepth. For example:
<parameter name="MaxInheritedLanguageDepth">2</parameter>
This specifies that an object can inherit two (2) levels up. In terms of parents, it inherits from the parent and the grandparent.
Creating language objects for translation
Content Manager methods for managing translation and creating language objects for translation depend on the Status of the source language objects, and the metadata fields:
  • Enable translation management
  • Requested Language
  • Inherited languages
Behavior

Assuming Enable translation management is selected for the object:

  • When an object is released, language objects are created for the languages specified as Requested Languages and Inherited languages for that object.
    • Requested Languages can be specified (user-defined) for the topic.
    • Inherited languages is a read-only field which the system populates from the Requested Languages for the parent object(s).
  • An object inherits languages from the parent(s) when the parent has a release status when the object is released.
  • If the object is released but the parent is not, the object does not inherit languages. In this case, when the object is released:
    • The only language objects that are created are those that are specified for the object itself as a Requested Language.
    • To generate other language objects, you must use the web interface Translation option.
Example: If Topic 1 has Japanese as a Requested Language and the map has German as the Requested Language then:
  • Scenario 1: You release the map then you release Topic 1:
    • The German language is inherited from the map.
    • The Japanese and German language objects are created for Topic 1.
  • Scenario 2: You release Topic 1 but the map remains in draft status:
    • The German language is not inherited because the map is not released.
    • Only the Japanese language object is created for Topic 1.
    • To create the German language object you must use the web client Translate option.