Translation editor for a specification text

Text definition's specification texts that were configured as translatable can be translated in the tool window in the Translation editor for translating a specification text into a display language.

Purpose

The editor for translating a specification text is used for translating a specification text and for adopting formatting from the source text.

Specification texts for the following text definitions can be translated in the editor:

  • Text definitions that were configured as formatable (Is Formatted Text) and translatable (is translatable)
  • Text definitions which cannot be formatted with the Document Area display variant that were configured as translatable

Call

If model elements which contain specification texts are shown in the Translation tool window, then these specification texts are also shown for all text definitions relevant for translations. The Text... button appears in the Translation column for each of these entries; you can use it to open the editor for translating a specification text.

Structure

The editor's document window is split into two. The left-hand area shows a specification text in the model language; the right-hand area shows the text in the display language.

Note

A text definition's specification text is shown.

You can use the is translatable property when configuring a text definition to set whether the assigned specifications can be translated.

Commands appear in the Text ribbon tab depending on what is selected in the left or right-hand area.

Translating Specifications

Working in the Editor

The original text in the model language can only be read in the left-hand area.

Enter the translation in the right-hand area. Commands for specification texts can be found in the Text ribbon.

Note

Spell check first checks the texts entered when it is saved in the active display language.

If an initial translation was created in the Translation tool window using a web service, then this is shown in the translation area on the right-hand side. The web service cannot work with character and paragraph formats. The text can always initially not be translated.

You can use the Text>Font>Format Painter command to copy formatting from the original text into the translation. You can also use this method to transfer hyperlinks.

Note

You must make sure that only one insertion point is set not a selection for formatting to be adopted.

You can adopt changes using the Text>Specification>Save (Ctrl+S) command.

If the active language in the Translation tool window or status bar are changed to the model language or another display language, then all editors for translating a specification text are closed. A dialog for saving changes appears if you have not yet saved changes.

Usable Functions in the Left-Hand Area of the Model Language

You cannot edit the specification text; it is read only. You can only copy the formatting into the right-hand area.

To do this, set the insertion point in the formatting or hyperlink that you want to transfer and select Text>Font>Format Painter.

To transfer the copied formatting to the paragraph, click in the paragraph in the right-hand area. The paragraph is formatted in the left-hand area.

To transfer the copied formatting to the connected text, select it in the right-hand area. The text is formatted in the left-hand area.

To transfer the copied hyperlink to the connected text, select it in the right-hand area. The text is formatted with the hyperlink.

Usable Functions in the Right-Hand Area of the Display Language

You can edit the specification text to be translated.

The editor has the following functions you can run via the context menu or the Text ribbon:

Placeholders

Specifications may contain placeholders which can also be used in the display language.

Specifications can contain the following placeholders:

  • $(model_name) is replaced by the name of the model.

  • $(name) is replaced by the name of the element.

  • $(creator) is replaced by the user who created the element.

  • $(creation_date) is replaced by the date the element was created.

  • $(modifier) is replaced by the name of the user who last modified the element.

  • $(modification_date) is replaced by the date the element was last modified.

  • $(history) is replaced by the usual history entry; this contains information about the date and time of creation and last modifications made by the respective user.

  • $l(<label name>) is replaced by the value of the label entered for the element. You must use the logical label name.

  • $(label) is replaced by a text which contains all assigned labels with their values in the form name : value. No Labels is generated if no labels are assigned.

  • $t(<text name>) is replaced by the value of the specification text entered for the element. Formatted texts are embedded without formatting. The logical text name must be used.

Supported Procedures in the Editor