# Create and Manage Cultures and Translatable Texts

This page describes the UI of each menu and feature for multi-languages settings. Please refer to the explanation on <span style="color: rgb(230, 126, 35);">[here](https://doc316en.candera.eu/books/getting-started/page/multi-languages-settings)</span> for details on how to configure multi-languages settings using this feature.

The translator plugin is fully integrated into SceneComposer. The SceneComposer toolbar provides an icon for opening the \[Culture Solution Options\] dialog as well as a drop-down menu for selecting an already created culture.

<div drawio-diagram="4439"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-10/drawing-4-1696313207.png" alt=""/></div>

In addition, the \[ Language \] menu on the menu bar contains the following five menus.

<div drawio-diagram="4430"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-10/drawing-4-1696311151.png" alt=""/></div>

- <span style="color: rgb(230, 126, 35);">[Culture Solution Option](#bkmrk-culture-solution-opt-1)</span>  
    Open the Culture Solution Option Dialog, where the user can add, edit or remove Culture as the multiple languages setting. By selecting a Culture in SceneComposer, you can switch between the displayed language of the solution. The translated texts displayed when selecting a Culture are configured in the Language Table.
- <span style="color: rgb(230, 126, 35);">[Export Languages](#bkmrk-import-and-export)</span>  
    Opens the *Select Cultures* dialog where you can select the languages you want to export and - after browsing to an export file path - you can export your selected languages in the format you prefer to the location you selected by pressing *Export*.
- <span style="color: rgb(230, 126, 35);">[Import Languages](#bkmrk-import-and-export)</span>  
    <div class="relative my-1 min-h-6">  
    </div><span style="background-color: rgb(251, 238, 184);">Opens the **Import Languages** dialog, where you can import a target file into the solution from any of the following sources: “Language Pack Source,” “Excel file,” or “XLIFF file (.xlf).”</span>
- <span style="color: rgb(230, 126, 35);">[Language Usage](#bkmrk-language-usage)</span>  
    Opens the Language Usage Dialog, where all Text Properties of the solution are listed. For those Text Properties that have a translatable text assigned, the *Text Id* and the *Text* value for the current culture are displayed. It is also possible to assign or unassign a translatable text for a Text Property.
- <span style="color: rgb(230, 126, 35);">[Language Table](#bkmrk-language-table)</span>  
    Opens the Language Table Dialog, where the user can add, edit or remove translatable texts. The Id of each translatable text is unique. The Text value for a certain culture can be accessed by selecting the respective culture in the Current Culture drop-down.

#### Culture Solution Option

To create text in different languages, a culture must be created. This is done by clicking on the Culture Solution Options button on the toolbar.

<div drawio-diagram="4438"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-10/drawing-4-1696313073.png" alt=""/></div>

See <span style="color: rgb(230, 126, 35);">[Solution Options &gt; Culture](https://doc316en.candera.eu/books/solution-handling/page/cultures)</span> for a detailed description of each item in the dialog that appears.


#### Language Table

Through the Language Table, you can configure the text that will be displayed when you select a language configured in Culture. Here, you can add, edit, or delete translated texts for each Culture. The translated text is the text that will be displayed according to the selected Culture in Scene Composer.

The settings can be accessed from the \[ Languages &gt; Language Table... \] menu bar. The settings are made in the Language Tables dialog, which can be opened from the menu bar \[ Languages&gt;Language Tables... \].

<div drawio-diagram="4437"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-10/drawing-4-1696313046.png" alt=""/></div>

<table border="1" id="bkmrk-%E6%A4%9C%E7%B4%A2%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89-%E6%A4%9C%E7%B4%A2%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89%E3%81%B8%E4%BB%BB%E6%84%8F%E3%81%AE%E6%96%87" style="width: 100%;"><tbody><tr><td style="width: 7.41244%;">(1)</td><td class="align-left" style="width: 17.0622%;">Search field</td><td style="width: 75.6489%;">You can search for a specific text entry by entering any string into the search field.

</td></tr><tr><td style="width: 7.41244%;">(2)</td><td class="align-left" style="width: 17.0622%;">**Unused only** check box</td><td style="width: 75.6489%;">When this check box is enabled, only text that is not assigned to a text object in the solution will be displayed.

</td></tr><tr><td style="width: 7.41244%;">(3)</td><td class="align-left" style="width: 17.0622%;">Culture Solution Option button

</td><td style="width: 75.6489%;">Click this icon to display the Cultures dialog box.</td></tr><tr><td style="width: 7.41244%;">(4)</td><td class="align-left" style="width: 17.0622%;">Select Cultures

</td><td style="width: 75.6489%;">Select a configured culture from the pull-down menu.</td></tr><tr><td style="width: 7.41244%;">(5)</td><td class="align-left" style="width: 17.0622%;">ID</td><td style="width: 75.6489%;">A unique identifier assigned to each translation text. It is automatically assigned when you add a translation text line by pressing the Add button.

</td></tr><tr><td style="width: 7.41244%;">(6)</td><td class="align-left" style="width: 17.0622%;">Text</td><td style="width: 75.6489%;">Sets the text to be displayed when using the culture currently selected in the Culture Selection pull-down menu.

</td></tr><tr><td style="width: 7.41244%;">(7)</td><td class="align-left" style="width: 17.0622%;">Translation Hint</td><td style="width: 75.6489%;">Allows you to enter a description for the translated text line.</td></tr><tr><td style="width: 7.41244%;">(8)</td><td class="align-left" style="width: 17.0622%;">Master Text</td><td style="width: 75.6489%;">Displays the text of the master culture. This item is not displayed when a master culture is selected in the culture selection pull-down menu.

</td></tr><tr><td style="width: 7.41244%;">(9)</td><td class="align-left" style="width: 17.0622%;">Add/Delete button</td><td style="width: 75.6489%;">This button allows you to add/delete language table setting rows. These buttons are only enabled when the master culture is selected in the \[ Current Culture \] field.

</td></tr><tr><td style="width: 7.41244%;">(10)</td><td class="align-left" style="width: 17.0622%;">Selected Text Assignments</td><td style="width: 75.6489%;">Displays the node to which the translated text line has been set. </td></tr><tr><td style="width: 7.41244%;">(11)</td><td class="align-left" style="width: 17.0622%;">Close button</td><td style="width: 75.6489%;">Closes the Localization Table dialog box.</td></tr></tbody></table>

#### Language Usage

For editing the texts' properties, Scene Composer provides the Text Properties Dialog, which can be opened via the menu *Language &gt; Language Usage...*.

This dialog lists all Text Properties of the solution. For those Text Properties that have a translatable text assigned, the *Text Id* and the *Text* value for the current culture are displayed. The current culture can be changed in the drop-down menu on the right. If necessary, the *Solution Options: Cultures* dialog can be opened with the globe icon on the left of the drop-down menu.

When pressing *Save*, the changes made to the Text Properties will be applied to the solution.

<div drawio-diagram="4436"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-10/drawing-4-1696312788.png" alt=""/></div>

<div class="contents" id="bkmrk--10"><div class="contents">  
</div></div>- When pressing the Assign button on the bottom of the dialog, the Language Table Selection dialog is opened where a text can be chosen from the list.
- Assigning texts to Text Properties can either be done in the Language Usage Dialog or in the Text Properties Panel.

The *Language Table Selection* dialog can also be opened when editing a Text property by clicking on the icon *Select template for item*.

<div drawio-diagram="4435"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-10/drawing-4-1696312677.png" alt=""/></div>

<div class="contents" id="bkmrk--12"><div class="contents">  
</div></div>#### Switching Cultures

If cultures and texts have been created and the texts are assigned to Text properties, the culture can be switched using the drop-down in the toolbar. As soon as another culture is chosen, the solution will be displayed in the other language.

<div class="contents" id="bkmrk-if-there-is-no-text-"><div class="textblock"><dl class="note"><dd><p class="callout info">If there is no text configured for a certain language, the *Text Id* will be displayed instead. Using this id, the missing text can easily be identified and found in the Language Table using the search function.  
</p>

<div drawio-diagram="3327"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-04/drawing-4-1682585479.png" alt=""/></div>

</dd></dl></div></div>