diff --git a/content/en/docs/refguide/modeling/menus/translatable-texts/_index.md b/content/en/docs/refguide/modeling/menus/translatable-texts/_index.md index b1c38e6ecf9..82f246d9e9d 100644 --- a/content/en/docs/refguide/modeling/menus/translatable-texts/_index.md +++ b/content/en/docs/refguide/modeling/menus/translatable-texts/_index.md @@ -54,15 +54,17 @@ The **Language** menu allows you to manage additional languages and translations The **Language** menu items are described in the table below: -| Menu Item | Description | Shortcut Key | -| --- | --- | --- | -| **Current Language** | Choose the current language from one of the languages set up in **Language Settings…**. | *None* | -| **Select Previous Language** | Choose the previous language in the list of languages chosen in **Language Settings…**. | Ctrl + Shift + L | -| **Select Next Language** | Choose the next language in the list of languages chosen in **Language Settings…**. | Ctrl + L | -| [Language Settings…](/refguide/language-settings/) | Choose which languages are supported by the app and configure date and time settings. | *None* | -| [Batch Replace…](/refguide/batch-replace/) | Change all occurrences of chosen translatable texts in the current language where they are identical. | *None* | -| [Batch Translate…](/refguide/batch-translate/) | Add and edit translations from a selected source language to a selected target language | *None* | -| [Language Operations…](/refguide/language-operations/) | Manipulate (for example, copy) translations between languages. | *None* | +| Menu Item | Description | Shortcut Key | +|-------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------| --- | +| **Current Language** | Choose the current language from one of the languages set up in **Language Settings…**. | *None* | +| **Select Previous Language** | Choose the previous language in the list of languages chosen in **Language Settings…**. | Ctrl + Shift + L | +| **Select Next Language** | Choose the next language in the list of languages chosen in **Language Settings…**. | Ctrl + L | +| [Language Settings…](/refguide/language-settings/) | Choose which languages are supported by the app and configure date and time settings. | *None* | +| [Batch Replace…](/refguide/batch-replace/) | Change all occurrences of chosen translatable texts in the current language where they are identical. | *None* | +| [Batch Translate…](/refguide/batch-translate/) | Add and edit translations from a selected source language to a selected target language | *None* | +| [Language Operations…](/refguide/language-operations/) | Manipulate (for example, copy) translations between languages. | *None* | +| [Advanced Translations Import](/refguide/advanced-translations-import/) | Import translations from Excel or PO files. | *None* | +| [Advanced Translations Export](/refguide/advanced-translations-export/) | Export translations as Excel or PO files. | *None* | ## Setting the End-User's Language diff --git a/content/en/docs/refguide/modeling/menus/translatable-texts/advanced-translations-export.md b/content/en/docs/refguide/modeling/menus/translatable-texts/advanced-translations-export.md new file mode 100644 index 00000000000..d7e686d400d --- /dev/null +++ b/content/en/docs/refguide/modeling/menus/translatable-texts/advanced-translations-export.md @@ -0,0 +1,56 @@ +--- +title: "Advanced Translations Export" +url: /refguide/advanced-translations-export/ +weight: 60 +--- + +## Introduction + +**Advanced Translations Export** allows you to export translations to Microsoft Excel (*.xlsx*) or PO (*.po*) format files. + +## Using Advanced Translations Export + +To export languages, from the top-bar menu, select **Language > Advanced Translations Export** and choose one of the following options: + +* **As Excel (.xlsx) file** – export translations to a Microsoft Excel (*.xlsx*) format file +* **As PO (.po) files** – export translations to PO (*.po*) format files + +{{< figure src="/attachments/refguide/modeling/menus/translatable-texts/advanced-translations-export.png" alt="Advanced Translations Export" >}} + +When you select an option, a directory selector appears. Select the directory containing the files you want to export. + +A pop-up will appear confirming the start of the export. + +### Export as Excel + +Click **As Excel (*.xlsx) file** and select a directory for the export. Studio Pro will create a subdirectory named in the format `Export_{app-name}_Xlsx_{time-stamp}`. The translations will be saved as a Microsoft Excel (*.xlsx*) format file. The file will be named in the format `{app-name}-translations.xlsx` (e.g. *App-translations.xlsx*) and contain the following columns: + +* `Mendix Reference` +* `Module` +* `Document` +* `Path to element` +* `Element` +* `Source Text ({source_language})` +* `{translation_language 1}` +* ... +* `{translation_language_n}` + +{{< figure src="/attachments/refguide/modeling/menus/translatable-texts/advanced-translations-excel.png" alt="Advanced Translations Export Excel" >}} + +{{% alert color="warning" %}} +The formats of the Excel file for **Advanced Translations Export** and [Advanced Translations Import](/refguide/advanced-translations-import/) are similar. However, the files are incompatible with export to Excel and import from Excel in [Batch Replace](/refguide/batch-replace/) and [Batch Translate](/refguide/batch-translate/). +{{% /alert %}} + +### Export as PO + +Click **As PO (`*.po*`) files** and select a directory for the export. Studio Pro will create a subdirectory named in the format `Export_{app-name}_Po_{time-stamp}`. The translations will be saved as PO (`*.po*`) format files. The files will be named in the format `{app-name}-{language}.po` (e.g. *App-en_US.po*). + +{{% alert color="warning" %}} +The formats of the PO files for **Advanced Translations Export** and [Advanced Translations Import](/refguide/advanced-translations-import/) are similar. +{{% /alert %}} + +After completion, a confirmation pop-up appears. If the operation fails, a failure pop-up is displayed instead. + +{{% alert color="warning" %}} +Do not close the app while the export is running. +{{% /alert %}} \ No newline at end of file diff --git a/content/en/docs/refguide/modeling/menus/translatable-texts/advanced-translations-import.md b/content/en/docs/refguide/modeling/menus/translatable-texts/advanced-translations-import.md new file mode 100644 index 00000000000..d51ab7edf80 --- /dev/null +++ b/content/en/docs/refguide/modeling/menus/translatable-texts/advanced-translations-import.md @@ -0,0 +1,58 @@ +--- +title: "Advanced Translations Import" +url: /refguide/advanced-translations-import/ +weight: 50 +--- + +## Introduction + +**Advanced Translations Import** allows you to import translations from Microsoft Excel (*.xlsx*) or PO (*.po*) format files. + +## Using Advanced Translations Import + +To import languages, from the top-bar menu, select **Language > Advanced Translations Import** and choose one of the following options: + +* **From Excel (.xlsx) file** – import translations from a Microsoft Excel (*.xlsx*) format file +* **From PO (.po) files** – import translations from PO (*.po*) format files + +{{< figure src="/attachments/refguide/modeling/menus/translatable-texts/advanced-translations-import.png" alt="Advanced Translations Import" >}} + +When you select an option, a directory selector appears. Select the directory containing the files you want to import. + +A pop-up will appear confirming the start of the import. + +### Import from Excel + +Click **From Excel (.xlsx) file** and select a directory containing a Microsoft Excel (*.xlsx*) format file. The file needs to meet the following requirements: + +* The file must be named in the format `{app-name}-translations.xlsx` (e.g. *App-translations.xlsx*) +* The file must have the following columns: + * `Mendix Reference` + * `Module` + * `Document` + * `Path to element` + * `Element` + * `Source Text ({source_language})` + * `{translation_language 1}` + * ... + * `{translation_language_n}` + +{{< figure src="/attachments/refguide/modeling/menus/translatable-texts/advanced-translations-excel.png" alt="Advanced Translations Import Excel" >}} + +{{% alert color="warning" %}} +The formats of the Excel file for **Advanced Translations Import** and [Advanced Translations Export](/refguide/advanced-translations-export/) are similar. However, the files are incompatible with import from Excel and export to Excel in [Batch Replace](/refguide/batch-replace/) and [Batch Translate](/refguide/batch-translate/). +{{% /alert %}} + +### Import from PO + +Click **From PO (.po) files** and select a directory containing PO (*.po*) format files. The files must be named in the format `{app-name}-{language}.po` (e.g. *App-en_US.po*). + +{{% alert color="warning" %}} +The formats of the PO files for **Advanced Translations Import** and [Advanced Translations Export](/refguide/advanced-translations-export/) are similar. +{{% /alert %}} + +After completion, a confirmation pop-up appears. If the operation fails, a failure pop-up is displayed instead. + +{{% alert color="warning" %}} +Do not close the app while the import is running. +{{% /alert %}} diff --git a/content/en/docs/refguide/modeling/menus/translatable-texts/language-settings.md b/content/en/docs/refguide/modeling/menus/translatable-texts/language-settings.md index 44c0351ba29..d7651cee668 100644 --- a/content/en/docs/refguide/modeling/menus/translatable-texts/language-settings.md +++ b/content/en/docs/refguide/modeling/menus/translatable-texts/language-settings.md @@ -1,7 +1,7 @@ --- title: "Language Settings" url: /refguide/language-settings/ -weight: 50 +weight: 10 --- ## Introduction diff --git a/content/en/docs/refguide/modeling/menus/translatable-texts/translatable-validation-messages.md b/content/en/docs/refguide/modeling/menus/translatable-texts/translatable-validation-messages.md index c0580d1eb37..e8fe6d9b1cf 100644 --- a/content/en/docs/refguide/modeling/menus/translatable-texts/translatable-validation-messages.md +++ b/content/en/docs/refguide/modeling/menus/translatable-texts/translatable-validation-messages.md @@ -1,7 +1,7 @@ --- title: "Using Translatable Validation Messages" url: /refguide/translatable-validation-messages/ -weight: 140 +weight: 160 description: "Describes how to use translatable validation messages." aliases: - /howto/logic-business-rules/translatable-validation-messages/ diff --git a/content/en/docs/refguide/modeling/menus/translatable-texts/translate-your-app-content.md b/content/en/docs/refguide/modeling/menus/translatable-texts/translate-your-app-content.md index 6665e404af4..c7f5d1b5d6f 100644 --- a/content/en/docs/refguide/modeling/menus/translatable-texts/translate-your-app-content.md +++ b/content/en/docs/refguide/modeling/menus/translatable-texts/translate-your-app-content.md @@ -1,7 +1,7 @@ --- title: "Translating Your App Content" url: /refguide/translate-your-app-content/ -weight: 50 +weight: 150 aliases: - /howto/collaboration-requirements-management/translate-your-app-content/ --- diff --git a/static/attachments/refguide/modeling/menus/translatable-texts/advanced-translations-excel.png b/static/attachments/refguide/modeling/menus/translatable-texts/advanced-translations-excel.png new file mode 100644 index 00000000000..5f7424fa734 Binary files /dev/null and b/static/attachments/refguide/modeling/menus/translatable-texts/advanced-translations-excel.png differ diff --git a/static/attachments/refguide/modeling/menus/translatable-texts/advanced-translations-export.png b/static/attachments/refguide/modeling/menus/translatable-texts/advanced-translations-export.png new file mode 100644 index 00000000000..4a972daf239 Binary files /dev/null and b/static/attachments/refguide/modeling/menus/translatable-texts/advanced-translations-export.png differ diff --git a/static/attachments/refguide/modeling/menus/translatable-texts/advanced-translations-import.png b/static/attachments/refguide/modeling/menus/translatable-texts/advanced-translations-import.png new file mode 100644 index 00000000000..7f3f468258b Binary files /dev/null and b/static/attachments/refguide/modeling/menus/translatable-texts/advanced-translations-import.png differ diff --git a/static/attachments/refguide/modeling/menus/translatable-texts/language-menu.png b/static/attachments/refguide/modeling/menus/translatable-texts/language-menu.png index 3176b7443a1..651027c800c 100644 Binary files a/static/attachments/refguide/modeling/menus/translatable-texts/language-menu.png and b/static/attachments/refguide/modeling/menus/translatable-texts/language-menu.png differ