diff --git a/docs/content_management/img/adding_translation.png b/docs/content_management/img/adding_translation.png deleted file mode 100644 index d0577fd9..00000000 Binary files a/docs/content_management/img/adding_translation.png and /dev/null differ diff --git a/docs/content_management/img/automated_translation.png b/docs/content_management/img/automated_translation.png deleted file mode 100644 index a299b9fd..00000000 Binary files a/docs/content_management/img/automated_translation.png and /dev/null differ diff --git a/docs/content_management/img/translation_preview_impossible.png b/docs/content_management/img/translation_preview_impossible.png deleted file mode 100644 index ea6ecfbb..00000000 Binary files a/docs/content_management/img/translation_preview_impossible.png and /dev/null differ diff --git a/docs/content_management/translate_content.md b/docs/content_management/translate_content.md index 2d32a971..63ce22d2 100644 --- a/docs/content_management/translate_content.md +++ b/docs/content_management/translate_content.md @@ -6,64 +6,67 @@ description: Create multiple language versions of content items and products. The content on your website can be translated into different languages. Each content item can have different language versions. -The version visible to a visitor depends on the way your installation is set up (see [SiteAccess concept](multisite.md#siteaccess)). +The application that consumes your content decides which version a visitor sees. -!!! tip "Translations management LTS Update" +[[= product_name =]] offers a [side-by-side translation view](#side-by-side-translation-view) that displays the source and target languages simultaneously. +It makes it easier for you to provide, edit, and review translations. - If the [Translations management](#translations-management) LTS Update is installed in your system, [[= product_name =]] offers a side-by-side translation view that displays the source and target languages simultaneously. - It makes it easier for you to provide, edit, and review translations. +You can also translate your content translated automatically by using an external translation service. +Automatic translation requires [configuration]([[= developer_doc =]]/multisite/translations_management/configure_translations_management) before you can use it. ## Add website languages -You can only add translations in languages that have been set up for your website in the **Admin** panel. -If your user [role](work_with_permissions.md) has the right permissions, you can create a new language for the website. +You can only add translations in languages that have been set up in the **Admin** panel. +If your user [role](work_with_permissions.md) has the right permissions, you can add a new language. To do it, go to the **Admin** panel, open the **Languages** tab, and click **Add language**. Every new language must have a name and a language code written in the xxx-XX format, for example, eng-US, fre-FR, or nor-NO. -After adding a language, you may have to reload the application to be able to use it. -!!! note "Website configuration" +Adding a language doesn't require any configuration changes. +As soon as you save it, the language is available for creating content items, products, and their translations. - Depending on the way the website is set up, additional configuration may be necessary for the new translations to be displayed properly. - Contact your administrator and inform them that you need to add a new language to the website. +## Add translations - For example, you can only preview content items translated to languages that have a corresponding website configured in that language. +1\. Either click **+ Add** in the content item's or product's **Translations** tab, or **Add translation** in the content tree. - ![Preview limitation](img/translation_preview_impossible.png "Preview limitation") +![Starting the translation from the content tree](img/translate_from_content_tree.png "Starting the translation from the content tree") - For more information, see [Developer Documentation on language versions]([[= developer_doc =]]/multisite/languages/languages/). +2\. In the **Create a new translation** modal, select the source and target languages. -## Add translations +!!! note "Draft conflict" -1\. In the left panel, go to **Content** -> **Content structure**. Then select a content item. + If a draft translation of the content item already exists for the selected target language, a warning appears in the modal to inform you about this fact. + You can proceed and add a new draft, or discard the modal and edit the existing draft translation. -2\. Go to **Translations** tab and click **+ Add**. + For more information, see [Edit existing translations](#edit-existing-translations). -3\. In the **Create a new translation** modal, select the source and target languages, then click **Create**. +3\. If **Use automatic translation** is checked, select a translation provider from a drop-down list. -All the fields are then pre-filled with the values they have in the base translation. -If you do not choose a base translation, the fields remain empty. +You may prefer to translate the content by yourself. +To do it, uncheck **Use automatic translation** and proceed. -While working, you can save your work and continue or click **Delete draft** to discard your changes. -When done, you can save your work and close the window, publish the translated article immediately, or pick another publication date. +![Create a new translation modal](img/translations_create_translation.png "Create a new translation modal") -Every time you add or edit a translation, a new version of the content item is created, -the same way as when editing only one language. +If no translation providers are configured in the system, or [the providers are disabled](#manage-translation-services-and-language-pairs), the checkbox is inactive. +If only one provider exists in the system, there is a checkbox, but no drop-down list. +When there are more than four translation services configured in the system, a search field appears in the drop-down list. -![Adding a new translation](img/adding_translation.png "Adding a new translation") +4\. Click **Open side-by-side**. -
+The [side-by-side translation view](#side-by-side-translation-view) opens with the source text in one column and the target form in the other. +Depending on whether you choose to use automatic translations, target fields can be empty or pre-translated. -## Automated translation +!!! note "Reviewing automatic translations" -If your application comes with a [properly configured automated translation feature]([[= developer_doc =]]/multisite/languages/automated_translations), you can have your content machine-translated into multiple languages by using external translation services like Google Translate and DeepL. + If you choose to use automatic translations, the side-by-side view allows you to approve or reject the translation. + For more information, see [Review automatic translation](#review-automatic-translation). -To use it, in the **Create a new translation** modal, select the source and target languages and the **Use automatic translation with...** checkbox. -If more than one service is configured, you can choose either of the available options. +5\. When you work with a product, **Save and close** publishes the translation and **Discard** removes it completely. -![Automated translation](img/automated_translation.png "Automated translation") +6\. When you work with other content items, you have multiple options to quit editing and preserve the translation, while **Delete draft** removes it completely. -When you click **Create**, all the Fields are pre-filled with the values in target language, provided by the selected translation service. +Every time you add or edit a translation, a new version of the content item is created, +the same way as when editing only one language. ## Translation comparison @@ -86,30 +89,12 @@ The screen refreshes to display the side by side view of its fields. For more information, see [Work with versions](work_with_versions.md#compare-versions). -## Translations management [[% include 'snippets/lts-update_badge.md' %]] - -If the translations management feature [is installed and properly configured]([[= developer_doc =]]/multisite/translations_management/translations_management) in your system, the set of features available for [content item](content_items.md) and [product](products.md) translation changes: - -- Application administrators can [define language pairs and assign translation services](#manage-translation-services-and-language-pairs) to them. -- Content editors get a redesigned translation interface called [side-by-side translation view](#side-by-side-translation-view). If at least one automated translation provider is configured, editors can use it to machine-translate content. - -!!! note "Limitations" - - [Pages](create_edit_pages.md) and [Forms](work_with_forms.md) don't support the side-by-side translation view and open in the single-language editor instead. - - When you translate them automatically: - - - Translatable page content, including text and RichText block attributes, is sent for translation, while layout, zones, and non-translatable block attributes are preserved from the source page. - - The form that you build with the Form Builder is not translated. - - Also, [product attributes](work_with_product_attributes.md) remain non-translatable and are inactive in the side-by-side translation view. - -### Manage translation services and language pairs +## Manage translation services and language pairs If you have Administrator permissions, you can enable and disable translation services and assign them to language pairs. Enabling at least one translation service is required before the editors can use automatic translation. -#### Translation services +### Translation services To see the translation services that are available in your system, go to **Admin** -> **Languages** -> **Translation services** tab. @@ -122,7 +107,7 @@ Disabled services don't appear as choices in the **Create a new translation** mo AI-based translation services require that policies related to [AI actions](work_with_ai_actions.md) are assigned to user roles. If an editor can't see AI-based services in the drop-down on the **Create a new translation** modal, check if the right permissions are granted in their role definition. -#### Language pairs +### Language pairs To manage language pairs, go to **Admin** -> **Languages** -> **Language pairs** tab. @@ -147,11 +132,22 @@ This creates one language pair per selected target language. Edit the existing language pair instead. To do it, you may need to temporarily re-enable the disabled services, so that all language pairs appear on the screen. -### Side-by-side translation view +## Side-by-side translation view The side-by-side translation view displays the source and target text of the content item or product on one screen. This way you can add, modify or review translations in context without having to switch between tabs or windows. +!!! note "Limitations" + + [Pages](create_edit_pages.md) and [Forms](work_with_forms.md) don't support the side-by-side translation view and open in the single-language editor instead. + + When you translate them automatically: + + - Translatable page content, including text and RichText block attributes, is sent for translation, while layout, zones, and non-translatable block attributes are preserved from the source page. + - The form that you build with the Form Builder is not translated. + + Also, [product attributes](work_with_product_attributes.md) remain non-translatable and are inactive in the side-by-side translation view. + The back office offers several entry points where you can access the side-by-side translation view, for example: - Content item's **Translations** tab — go to **Content** -> **Content structure**, select a content item, open the **Translations** tab, and click **+ Add**. @@ -159,7 +155,7 @@ The back office offers several entry points where you can access the side-by-sid - **Content tree** — click the three dots icon next to a content item in the content tree and, in the context menu, click **Add translation**. - **Content edit view** — when you choose to edit a content item and several language versions exist, the **Edit side-by-side** button is active for all languages except for the main language of the content item. -#### Source and target columns +### Source and target columns Depending on [user settings](get_started.md#user-settings), the source language column appears on the left or right of the side-by-side view. By default, the source is on the left. @@ -175,14 +171,14 @@ The view also supports the [distraction-free mode](create_edit_content_items.md# ![Distraction-free mode](img/translations_distraction_free_mode.png "Distraction-free mode") -#### Change source language +### Change source language When a content item or product has multiple published language versions, a drop-down list appears at the top of the source column. You can use the drop-down list to change the language that is displayed in the source column. ![Source language selection](img/translations_select_source.png "Source language selection") -#### Copy content from source +### Copy content from source The divider between the source and target columns contains a **Copy all from source** button. Click it to copy all translatable field values from the source column into the target fields in a single action. @@ -197,54 +193,14 @@ Values of all fields are copied at the same time. The button is absent if you switch to the [distraction-free mode](create_edit_content_items.md#distraction-free-mode). -#### Hide the source +### Hide the source When the source is placed on the right, the divider between the source and target columns contains a **Collapse source language** button. The button toggles the source panel visibility, allowing editors to hide the source text when they no longer need it. ![Collapse source button](img/translations_collapse_source.png "Collapse source button") -### Add new translation - -1\. Either click **+ Add** in the content item's or product's **Translations** tab, or **Add translation** in the content tree. - -![Starting the translation from the content tree](img/translate_from_content_tree.png "Starting the translation from the content tree") - -2\. In the **Create a new translation** modal, select the source and target languages. - -!!! note "Draft conflict" - - If a draft translation of the content item already exists for the selected target language, a warning appears in the modal to inform you about this fact. - You can proceed and add a new draft, or discard the modal and edit the existing draft translation. - - For more information, see [Edit existing translations](#edit-existing-translations). - -3\. If **Use automatic translation** is checked, select a translation provider from a drop-down list. - -You may prefer to translate the content by yourself. -To do it, uncheck **Use automatic translation** and proceed. - -![Create a new translation modal](img/translations_create_translation.png "Create a new translation modal") - -If no translation providers are configured in the system, or [the providers are disabled](#manage-translation-services-and-language-pairs), the checkbox is inactive. -If only one provider exists in the system, there is a checkbox, but no drop-down list. -When there are more than four translation services configured in the system, a search field appears in the drop-down list. - -4\. Click **Open side-by-side**. - -The [side-by-side translation view](#side-by-side-translation-view) opens with the source text in one column and the target form in the other. -Depending on whether you choose to use automatic translations, target fields can be empty or pre-translated. - -!!! note "Reviewing automatic translations" - - If you choose to use automatic translations, the side-by-side view allows you to approve or reject the translation. - For more information, see [Review automatic translation](#review-automatic-translation). - -5\. When you work with a product, **Save and close** publishes the translation and **Discard** removes it completely. - -6\. When you work with other content items, you have multiple options to quit editing and preserve the translation, while **Delete draft** removes it completely. - -### Edit existing translations +## Edit existing translations The back office offers several entry points where you can edit existing content item or product translations. @@ -278,7 +234,7 @@ This opens the existing draft in the side-by-side translation view, so you can r Products don't have draft translations. Product translations are published instantly when you click **Save and close** in the editing window. -### Review automatic translation +## Review automatic translation If a content item or product has draft translations created with automatic translation, the **Versions** tab displays a **Translation status** column. Such drafts are marked with one of the following badges: @@ -294,7 +250,7 @@ When you create and open an automatic translation or open a draft translation of ![Review banner in the side-by-side view](img/translations_review_banner.png "Review banner in the side-by-side view") -#### Reject translation +### Reject translation On the review banner, click **Reject** to mark the translation as requiring further work. The review banner hides but it reappears the next time you open the translation. @@ -309,7 +265,7 @@ You can reject a translation multiple times, but you can't reject a translation For products, rejecting a translation and then saving and closing the editing window publishes the translation despite its review status. -#### Accept translation +### Accept translation On the review banner, click **Accept** to mark the translation as reviewed and approved. The review banner disappears permanently and the status changes from **For review** to **Translated**. diff --git a/docs/getting_started/get_started.md b/docs/getting_started/get_started.md index d8602e27..19847ca2 100644 --- a/docs/getting_started/get_started.md +++ b/docs/getting_started/get_started.md @@ -118,7 +118,7 @@ Here you can [change your user password](get_started.md#change-the-password) and |Product tour|Enables or disables the [product tour onboarding](#onboarding) walkthroughs. | |Product tour scenarios settings|Separate setting for each available product tour scenario. Allows you to mark each scenario as completed or reset its progress.| |Side-by-side layout|Decides on which side of the screen the target language column should be displayed in the [side-by-side translation view](translate_content.md#side-by-side-translation-view). | -|Automatic translation for new items|Controls the behavior of the [**Create a new translation** modal](translate_content.md#add-new-translation). When activated, the **Use automatic translation** checkbox is selected and the default translation service for the language pair is preselected. Inactive when no automated translation services are defined. | +|Automatic translation for new items|Controls the behavior of the [**Create a new translation** modal](translate_content.md#add-translations). When activated, the **Use automatic translation** checkbox is selected and the default translation service for the language pair is preselected. Inactive when no automated translation services are defined. | #### Mode diff --git a/docs/images/notification-lts-update.svg b/docs/images/notification-lts-update.svg deleted file mode 100644 index 78ea75e2..00000000 --- a/docs/images/notification-lts-update.svg +++ /dev/null @@ -1,15 +0,0 @@ - - - - - - - - - - - - - - - \ No newline at end of file diff --git a/docs/index.md b/docs/index.md index 778706c1..60bf9e63 100644 --- a/docs/index.md +++ b/docs/index.md @@ -86,7 +86,7 @@
-
+

The latest release is [[= latest_tag_5_0 =]]

@@ -100,21 +100,6 @@
-
-
-
-

The newest LTS Update is Translations management

-
Use machine translation, side-by-side editing view, and a review cycle to improve your translation experience.
-
-
- Learn more about this LTS Update - Discover other LTS Updates -
-
- LTS Update -
-
-