Skip to content

Commit 26f6b6f

Browse files
committed
Review Language menu
1 parent 9c28a83 commit 26f6b6f

5 files changed

Lines changed: 88 additions & 93 deletions

File tree

content/en/docs/refguide/modeling/menus/translatable-texts/batch-translate.md

Lines changed: 28 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -6,94 +6,91 @@ weight: 30
66

77
## Introduction
88

9-
**Batch translate** allows you to enter texts in one language which correspond to texts in another language.
9+
**Batch translate** allows you to enter texts in one language that correspond to texts in another language.
1010

11-
Usually you will want to translate from the default language to a second language, but you can use any other dictionary of texts. For example, if your default language is *English, United States* you may already have translated the text into *Dutch, Netherlands* and you can use this as a reference for translating into *Dutch, Belgium* as there are likely to be more similarities.
11+
You usually translate from the default language to a second language, but you can use any other dictionary of texts. For example, if your default language is *English, United States*, you may already have translated the text into *Dutch, Netherlands* and you can use this as a reference for translating into *Dutch, Belgium* because there are likely to be more similarities.
1212

13-
{{< figure src="/attachments/refguide/modeling/menus/translatable-texts/batch-translate/batch-translate.png" width="600" >}}
13+
{{< figure src="/attachments/refguide/modeling/menus/translatable-texts/batch-translate/batch-translate.png" alt="" width="600" >}}
1414

1515
## Using Batch Translate
1616

17-
Batch translate translates between two languages. When you select batch translate you will be asked to select the two languages you wish to use, a **Source language** to use as a reference, and a **Destination language** which is the one you want to update.
17+
Batch translate translates between two languages. When you select batch translate, you are prompted to select the two languages you want to use: a **Source language** to use as a reference, and a **Destination language** that you want to update.
1818

1919
{{< figure src="/attachments/refguide/modeling/menus/translatable-texts/batch-translate/batch-translate-languages.png" alt="Select source and destination languages" width="600" >}}
2020

2121
### Documents/Modules
2222

23-
You can select one or more modules you want to use for batch translate. For example, you may have already got translations for imported and system modules and want to concentrate on translating your own modules.
23+
You can select one or more modules you want to use for batch translate. For example, you may already have translations for imported and system modules and want to concentrate on translating your own modules.
2424

25-
Click **Select…** and check the modules you want to work on.
25+
Click **Select…** and select the modules you want to work on.
2626

2727
{{< figure src="/attachments/refguide/modeling/menus/translatable-texts/batch-replace/batch-replace-modules.png" alt="Module selection screen" width="400" >}}
2828

29-
The default is to work on all modules in the app.
29+
By default, batch translate works on all modules in the app.
3030

3131
### Search
3232

33-
To search for a particular phrase in the source language text, type what you want to search for. It is not possible to search for text in the destination language.
33+
To search for a particular phrase in the source language text, type the text you want to search for. You cannot search for text in the destination language.
3434

3535
{{< figure src="/attachments/refguide/modeling/menus/translatable-texts/batch-translate/batch-translate-search.png" alt="Batch translate search" width="600" >}}
3636

37-
By default, all the translatable text from the selected module (or modules) will be shown.
37+
By default, all translatable text from the selected module (or modules) is shown.
3838

39-
Each found text will be displayed in the **Source** column.
40-
The **#** column shows the number of times it occurs in the selected module (or modules).
39+
Each found text is displayed in the **Source** column. The **#** column shows the number of times it occurs in the selected module (or modules).
4140

42-
If you select a line, you can look in the **Show occurrence** section to see the **Object** containing the text and the **Document** it appears in. Double-clicking or clicking **Show occurrence** will open the document and select the object so you can easily see the context.
41+
If you select a line, you can look in the **Show occurrence** section to see the **Object** containing the text and the **Document** it appears in. Double-clicking or clicking **Show occurrence** opens the document and selects the object so you can easily see the context.
4342

4443
{{% alert color="success" %}}
45-
Tip: move the dialog box to one side to get a better look at the document.
44+
Move the dialog box to one side to get a better look at the document.
4645
{{% /alert %}}
4746

4847
### Translation
4948

5049
{{% alert color="info" %}}
51-
Alternatively, you can use the AI-powered translation tool [Translation Generator](/refguide/translation-generator/) to generate translations for you. You can enable it via **Preferences** > the **New Features** tab > the **Maia** section.
50+
Alternatively, you can use the AI-powered translation tool [Translation Generator](/refguide/translation-generator/) to generate translations. You can enable it via **Preferences** > the **New Features** tab > the **Maia** section.
5251
{{% /alert %}}
5352

5453
In **Translation**, type new text that you want to use instead of the existing text. Click **Translate** to confirm the replacement.
5554

56-
{{< figure src="/attachments/refguide/modeling/menus/translatable-texts/batch-translate/batch-translate-translate.png" width="600" >}}
55+
{{< figure src="/attachments/refguide/modeling/menus/translatable-texts/batch-translate/batch-translate-translate.png" alt="" width="600" >}}
5756

58-
If you have two texts which are identical in the source language but different in the translation language, you will have to review and change these individually. This is not very common but imagine, for example, you have used `Order Lines` to both *describe the lines on an order* and to *label a button which sorts some lines*. See [Working in the Currently Selected Language](/refguide/translatable-texts/#selected-language) in *Language Menu* to find how to change individual texts.
57+
If you have two texts that are identical in the source language but different in the translation language, you must review and change these individually. This is not very common, but imagine, for example, you have used `Order Lines` to both *describe the lines on an order* and to *label a button that sorts some lines*. See [Working in the Currently Selected Language](/refguide/translatable-texts/#selected-language) in *Language Menu* to find how to change individual texts.
5958

6059
## Exporting and Importing Text {#export-import}
6160

62-
If you want to translate a language outside Studio Pro, you can export the translatable texts to the Microsoft Excel (*.xlsx*) format, make changes, and then import the changes from the updated Excel file.
61+
If you want to translate a language outside Studio Pro, you can export the translatable texts to Microsoft Excel (*.xlsx*) format, make changes, and then import the changes from the updated Excel file.
6362

6463
This is particularly useful if you are working on multiple apps and you want to apply your translations to a different app.
6564

6665
### Export to Excel {#export}
6766

68-
Click **Export to Excel** to export the currently displayed text items to a Microsoft Excel (*.xlsx*) format file.
67+
Click **Export to Excel** to export the currently displayed text items to a Microsoft Excel (*.xlsx*) format file.
6968

70-
The file will be in the format shown below:
69+
The file is in the format shown below:
7170

7271
{{< figure src="/attachments/refguide/modeling/menus/translatable-texts/batch-translate/batch-translate-excel.png" alt="Sample Excel file" width="400" >}}
7372

74-
**Row 1***Filter:* indicates the modules which are included in the exported file.
73+
* **Row 1***Filter:* indicates the modules that are included in the exported file
74+
* **Row 2** – indicates the source and translation language; the first column represents the current text, the second column the *translation* text
75+
* **Rows 3+** – show the current texts
7576

76-
**Row 2** – indicates the source and translation language. The first column represents the current text, the second column the *translation* text.
77-
78-
**Rows 3+** – show the current texts
79-
80-
You can make changes in column B which will be processed if the file is imported.
77+
You can make changes in column B that are processed if the file is imported.
8178

8279
### Import from Excel {#import}
8380

84-
Click **Import from Excel…** to import a correctly-constructed Microsoft Excel (*.xlsx*) format file.
81+
Click **Import from Excel…** to import a correctly constructed Microsoft Excel (*.xlsx*) format file.
8582

8683
This does the following:
8784

8885
* The selected module (or modules) are set to the ones in the *Filter:* line of the file
89-
* Any texts which are empty in column B will be ignored
90-
* Any texts in column A which do not match translatable texts in the selected module (or modules) will be ignored
91-
* Any text in column B which is not ignored is entered into the **Translation** column
86+
* Any texts that are empty in column B are ignored
87+
* Any texts in column A that do not match translatable texts in the selected module (or modules) are ignored
88+
* Any text in column B that is not ignored is entered into the **Translation** column
9289

93-
Changes will only be made if you click **Translate**.
90+
Changes are only made if you click **Translate**.
9491

9592
{{% alert color="warning" %}}
96-
The formats of the Excel files for batch translate and batch replace are similar. You will be warned if you try to import a batch replace file or a batch translate file with the incorrect languages but you can still import it if you ignore the warning.
93+
The formats of the Excel files for batch translate and batch replace are similar. You are warned if you try to import a batch replace file or a batch translate file with the incorrect languages, but you can still import it if you ignore the warning.
9794
{{% /alert %}}
9895

9996
## Read More

content/en/docs/refguide/modeling/menus/translatable-texts/language-operations.md

Lines changed: 8 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ weight: 40
66

77
## Introduction
88

9-
When creating an app in multiple languages, there are a number of tasks which you may want to carry out on all the texts in the app, or in a specific module.
9+
When creating an app in multiple languages, there are a number of tasks that you may want to carry out on all the texts in the app, or in a specific module.
1010

1111
**Language Operations** enable you to perform the following operations for a language dictionary. You can decide which modules the operation applies to:
1212

@@ -15,19 +15,19 @@ When creating an app in multiple languages, there are a number of tasks which yo
1515
* **Swap** texts between two language dictionaries
1616
* **Delete** texts from one language dictionary
1717

18-
{{< figure src="/attachments/refguide/modeling/menus/translatable-texts/language-operations/language_operations.png" class="no-border" width="800" >}}
18+
{{< figure src="/attachments/refguide/modeling/menus/translatable-texts/language-operations/language_operations.png" alt="" class="no-border" width="800" >}}
1919

2020
## Selecting Modules
2121

2222
In the **Selection** section of the dialog box, you can select the modules that you want to manage.
2323

24-
For each module, you can see the number of translatable texts which have been entered in each language which contains items. The gray columns indicate languages which are not selected in the app, but which contain translated texts. This enables you to remove a language from the app but still have access to the existing texts.
24+
For each module, you can see the number of translatable texts that have been entered in each language that contains items. The gray columns indicate languages that are not selected in the app, but that contain translated texts. This enables you to remove a language from the app but still have access to the existing texts.
2525

2626
## Performing Operations
2727

2828
Select an **Operation** to carry out on the selected module (or modules).
2929

30-
There are four language operation options, described below. These can be carried out for any language which has been selected in the app, plus any other languages which have translated texts.
30+
There are four language operation options, described below. These can be carried out for any language that has been selected in the app, plus any other languages that have translated texts.
3131

3232
Click **Apply** to apply the selected language operation.
3333

@@ -38,9 +38,8 @@ Click **Apply** to apply the selected language operation.
3838
Select the **Source language** and the **Destination language** from the drop-down menus.
3939

4040
{{% alert color="info" %}}
41-
42-
* Texts that are absent in the source language will be absent in the destination language – any original text will be removed
43-
* All the texts in the source language will be deleted
41+
* Texts that are absent in the source language are absent in the destination language – any original text is removed
42+
* All the texts in the source language are deleted
4443
{{% /alert %}}
4544

4645
### Copy
@@ -50,7 +49,7 @@ Select the **Source language** and the **Destination language** from the drop-do
5049
Select the **Source language** and the **Destination language** from the drop-down menus.
5150

5251
{{% alert color="info" %}}
53-
Texts that are absent in the source language will be absent in the destination language – any original text will be removed
52+
Texts that are absent in the source language are absent in the destination language – any original text is removed.
5453
{{% /alert %}}
5554

5655
### Swap
@@ -61,6 +60,6 @@ Select the **Source language** and the **Destination language** from the drop-do
6160

6261
### Delete {#delete}
6362

64-
**Delete** deletes all the texts in a selected language.
63+
**Delete** deletes all the texts in a selected language.
6564

6665
Select the language from the **Language** drop-down menu.

content/en/docs/refguide/modeling/menus/translatable-texts/language-settings.md

Lines changed: 14 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -6,9 +6,9 @@ weight: 10
66

77
## Introduction
88

9-
Mendix is designed to be used by users in multiple languages. The **Languages** tab of the **App Settings** allows you to select which languages your app will support.
9+
Mendix is designed to be used by users in multiple languages. The **Languages** tab of the **App Settings** allows you to select which languages your app supports.
1010

11-
{{< figure src="/attachments/refguide/modeling/menus/translatable-texts/language-settings/app-settings.png" width="550px" >}}
11+
{{< figure src="/attachments/refguide/modeling/menus/translatable-texts/language-settings/app-settings.png" alt="" width="550px" >}}
1212

1313
You can reach this tab in two ways:
1414

@@ -17,22 +17,22 @@ You can reach this tab in two ways:
1717

1818
## Setting Default Language
1919

20-
There must be a default app language. Select the **Default language** from the drop-down list. This will contain all languages which have been added to your app. It is recommended that you do this when you start developing your app.
20+
There must be a default app language. Select the **Default language** from the drop-down list. This contains all languages that have been added to your app. Mendix recommends that you do this when you start developing your app.
2121

2222
Setting the default language has two functions:
2323

24-
* It sets the language which will be displayed to the end-user if the end-user is not associated with a Language entity, or if the end-user's language is not enabled in the app
25-
* It sets the language which will be used if there is no translation of a translatable text in the end-user's language, even if the app has the language enabled
24+
* It sets the language that is displayed to the end-user if the end-user is not associated with a Language entity, or if the end-user's language is not enabled in the app
25+
* It sets the language that is used if there is no translation of a translatable text in the end-user's language, even if the app has the language enabled
2626

2727
The initial default language is *English, United States*.
2828

2929
## Adding Languages
3030

3131
You can add as many languages as you like from the list of supported languages by clicking **Add**, selecting the desired language, and clicking **OK**.
3232

33-
{{< figure src="/attachments/refguide/modeling/menus/translatable-texts/language-settings/add-language.png" width="500px" >}}
33+
{{< figure src="/attachments/refguide/modeling/menus/translatable-texts/language-settings/add-language.png" alt="" width="500px" >}}
3434

35-
Most languages will be added with an empty dictionary, although some translations have already been set up in the Dutch dictionary.
35+
Most languages are added with an empty dictionary, although some translations have already been set up in the Dutch dictionary.
3636

3737
## Advanced Language Settings{#advanced}
3838

@@ -42,9 +42,9 @@ You can set each language in your app to have additional settings.
4242

4343
### Check Completeness
4444

45-
If you check the **Check completeness** box, you will get a warning (or error) message in the [Errors pane](/refguide/errors-pane/) for every text which has no entry in this language's dictionary.
45+
If you select the **Check completeness** box, you get a warning (or error) message in the [Errors pane](/refguide/errors-pane/) for every text that has no entry in this language's dictionary.
4646

47-
If this is the default language, the **Check completeness** box will be checked and you will not be able to uncheck it.
47+
If this is the default language, the **Check completeness** box is selected and you cannot clear it.
4848

4949
### Custom Date and Time Formatting
5050

@@ -54,25 +54,23 @@ You can set a custom format for the following:
5454
* **Time format**
5555
* **Date and time format**
5656

57-
Type a format string in the relevant box and you will see an example of how a date will be formatted underneath.
57+
Type a format string in the relevant box and you see an example of how a date is formatted underneath.
5858

59-
Click **Edit…** to open a dialog box which will provide a full reference for the format string:
59+
Click **Edit…** to open a dialog box that provides a full reference for the format string:
6060

6161
{{< figure src="/attachments/refguide/modeling/menus/translatable-texts/language-settings/date-format.png" width="550px" alt="Date edit dialog" >}}
6262

6363
The list of supported tokens can be found in [Parse and Format Date Function Calls](/refguide/parse-and-format-date-function-calls/).
6464

6565
## List of Supported Languages {#supported-languages}
6666

67-
The most up-to-date list of supported languages in your version of Studio Pro is the one in the add languages menu.
67+
The most up-to-date list of supported languages in your version of Studio Pro is the one in the add languages menu.
6868

6969
{{% alert color="info" %}}
70-
71-
You cannot add custom languages that are not listed in supported languages below.
72-
70+
You cannot add custom languages that are not listed in supported languages below.
7371
{{% /alert %}}
7472

75-
The list below is provided to enable you to quickly evaluate if Mendix supports your desired language.
73+
The list below is provided to enable you to quickly evaluate whether Mendix supports your desired language.
7674

7775
| Language | Region | Locale | Available Since |
7876
| --- | --- | --- | --- |

0 commit comments

Comments
 (0)