From 5a969b584c5536a13f169447c1b71a5a0bcf390b Mon Sep 17 00:00:00 2001 From: deerskindoll Date: Tue, 2 Dec 2025 14:31:51 +0100 Subject: [PATCH 1/6] RHIDP-10990 --- ...c-adding-localization-to-custom-plugins.adoc | 3 ++- .../proc-customize-rhdh-language.adoc | 16 +++++++++------- .../proc-enabling-localization-in-rhdh.adoc | 17 +++++++++++++---- .../proc-overriding-translations.adoc | 5 +++-- .../proc-select-rhdh-language.adoc | 8 +++++--- 5 files changed, 32 insertions(+), 17 deletions(-) diff --git a/modules/customizing-the-appearance/proc-adding-localization-to-custom-plugins.adoc b/modules/customizing-the-appearance/proc-adding-localization-to-custom-plugins.adoc index 73be45d47d..f5f41e735a 100644 --- a/modules/customizing-the-appearance/proc-adding-localization-to-custom-plugins.adoc +++ b/modules/customizing-the-appearance/proc-adding-localization-to-custom-plugins.adoc @@ -2,6 +2,7 @@ [id="proc-adding-localization-to-custom-plugins_{context}"] = Implementing localization support for your custom plugins + You can implement localization support in your custom {product-very-short} plugins so that your plugins are accessible to a diverse, international user base and follow recommended best practices. .Procedure @@ -273,4 +274,4 @@ jest.mock("../hooks/useTranslation", () => ({ })); // Your test code... ----- \ No newline at end of file +---- diff --git a/modules/customizing-the-appearance/proc-customize-rhdh-language.adoc b/modules/customizing-the-appearance/proc-customize-rhdh-language.adoc index a64e242f67..8c3dfbe385 100644 --- a/modules/customizing-the-appearance/proc-customize-rhdh-language.adoc +++ b/modules/customizing-the-appearance/proc-customize-rhdh-language.adoc @@ -3,16 +3,18 @@ [id="proc-customize-rhdh-language_{context}"] = Customizing the language for your {product-short} instance -The language settings of {product-very-short} use English by default. You can choose to use one of the following languages instead. + +Use the *Appearance* panel to select a language for {product-very-short}. .Supported languages -* English +* English (default) * French +* Italian -[NOTE] -==== -English and French are the supported languages in {product-very-short} 1.8. You can add other languages in the the `i18n` section of your `{my-app-config-file}` configuration file. -==== +//[NOTE] +//==== +//You can add other languages in the `i18n` section of your `{my-app-config-file}` configuration file. +//==== .Prerequisites @@ -23,4 +25,4 @@ English and French are the supported languages in {product-very-short} 1.8. You . From the {product-short} web console, click *Settings*. . From the *Appearance* panel, click the language dropdown to select your language of choice. + -image::rhdh/customize-language-dropdown.png[] \ No newline at end of file +image::rhdh/customize-language-dropdown.png[] diff --git a/modules/customizing-the-appearance/proc-enabling-localization-in-rhdh.adoc b/modules/customizing-the-appearance/proc-enabling-localization-in-rhdh.adoc index 50c1c05076..e96ae79086 100644 --- a/modules/customizing-the-appearance/proc-enabling-localization-in-rhdh.adoc +++ b/modules/customizing-the-appearance/proc-enabling-localization-in-rhdh.adoc @@ -2,17 +2,25 @@ [id="proc-enabling-localization-in-rhdh_{context}"] = Enabling the localization framework in {product-short} + Enabling localization enhances accessibility, improves the user experience for a global audience, and assists organizations in meeting language requirements in specific regions. -The language settings of {product} ({product-very-short}) use English by default. In {product-very-short} {product-version}, you can choose to use one of the following supported languages: +Learn how to enable the localization framework to add a localization feature to {product-very-short}. +The following languages are supported: * English (en) * French (fr) +* Italian (it) + +[NOTE] +==== +The default language for {product-very-short} is English. +==== .Prerequisites .Procedure -. To enable the localization framework in your {product-very-short} application, add the `i18n` section to your custom {product-short} `{my-app-config-file}` configuration file: +. Add the `i18n` section to your custom {product-short} `{my-app-config-file}` configuration file: + [id=i18n] .`{my-app-config-file}` fragment with localization `i18n` fields @@ -23,6 +31,7 @@ i18n: locales: # List of supported locales. Must include `en`, otherwise the translation framework will fail to load. - en - fr + - it defaultLocale: en # Optional. Defaults to `en` if not specified. -... ----- \ No newline at end of file +... +---- diff --git a/modules/customizing-the-appearance/proc-overriding-translations.adoc b/modules/customizing-the-appearance/proc-overriding-translations.adoc index 6de959d813..5908d8a076 100644 --- a/modules/customizing-the-appearance/proc-overriding-translations.adoc +++ b/modules/customizing-the-appearance/proc-overriding-translations.adoc @@ -2,7 +2,8 @@ [id="prov-overriding-translations_{context}"] = Overriding translations -In {product-very-short} 1.8, you can override plugin translation strings without modifying the plugin source code. + +You can override plugin translation strings without modifying the plugin source code. .Prerequisites * You have enabled localization in your {product-very-short} application. @@ -117,4 +118,4 @@ i18n: // * xref:proc-enabling-localization-in-floating-action-button_{context}[fggdsg] // * xref:proc-enabling-localization-in-quickstarts_{context}[fggdsg] -// * xref:proc-enabling-localization-in-sidebar-menu-items_{context}[fggdsg] \ No newline at end of file +// * xref:proc-enabling-localization-in-sidebar-menu-items_{context}[fggdsg] diff --git a/modules/customizing-the-appearance/proc-select-rhdh-language.adoc b/modules/customizing-the-appearance/proc-select-rhdh-language.adoc index 3bb91ca3fc..1d7bec9c36 100644 --- a/modules/customizing-the-appearance/proc-select-rhdh-language.adoc +++ b/modules/customizing-the-appearance/proc-select-rhdh-language.adoc @@ -3,19 +3,21 @@ [id="proc-selecting-rhdh-language_{context}"] = Selecting the language for your {product-short} instance -You can choose to use one of the following supported languages: +Use the *Appearance* panel to select a language for {product-very-short}. +.Supported languages * English (default) * French +* Italian .Prerequisites * You are logged in to the {product-short} web console. -* You have xref:proc-enabling-localization-in-rhdh_{context}[enabled the localization framework] in your {product-very-short} instance. +* You have xref:proc-enabling-localization-in-rhdh_{context}[enabled the localization framework] in your {product-very-short} instance. .Procedure . From the {product-short} web console, click the down arrow next to your profile name, then click *Settings*. . From the *Appearance* panel, click the language dropdown to select your language of choice. + -image::rhdh/customize-language-dropdown.png[] \ No newline at end of file +image::rhdh/customize-language-dropdown.png[] From f2528ec6c955479f598fc6ee8a07a7fa7b43e0d2 Mon Sep 17 00:00:00 2001 From: deerskindoll Date: Thu, 4 Dec 2025 18:40:28 +0100 Subject: [PATCH 2/6] RHIDP-8066 --- .../customizing-the-appearance/proc-overriding-translations.adoc | 1 + 1 file changed, 1 insertion(+) diff --git a/modules/customizing-the-appearance/proc-overriding-translations.adoc b/modules/customizing-the-appearance/proc-overriding-translations.adoc index 5908d8a076..a136e1c8f2 100644 --- a/modules/customizing-the-appearance/proc-overriding-translations.adoc +++ b/modules/customizing-the-appearance/proc-overriding-translations.adoc @@ -100,6 +100,7 @@ i18n: locales: # List of supported locales. Must include `en`, otherwise the translation framework will fail to load. - en - fr + - it defaultLocale: en # Optional. Defaults to `en` if not specified. overrides: # List of JSON translation files applied in order (last file wins). Each file may override/add translations for one or more plugins/locales - /opt/app-root/src/translations/all-translations.json From 1f69137bd964a008bdb4ff702c0ebc54e43c7c8d Mon Sep 17 00:00:00 2001 From: deerskindoll Date: Thu, 11 Dec 2025 11:11:39 +0100 Subject: [PATCH 3/6] added Japanese --- .../proc-customize-rhdh-language.adoc | 1 + .../proc-enabling-localization-in-rhdh.adoc | 2 ++ .../proc-overriding-translations.adoc | 1 + 3 files changed, 4 insertions(+) diff --git a/modules/customizing-the-appearance/proc-customize-rhdh-language.adoc b/modules/customizing-the-appearance/proc-customize-rhdh-language.adoc index 8c3dfbe385..b8876bb48a 100644 --- a/modules/customizing-the-appearance/proc-customize-rhdh-language.adoc +++ b/modules/customizing-the-appearance/proc-customize-rhdh-language.adoc @@ -10,6 +10,7 @@ Use the *Appearance* panel to select a language for {product-very-short}. * English (default) * French * Italian +* Japanese //[NOTE] //==== diff --git a/modules/customizing-the-appearance/proc-enabling-localization-in-rhdh.adoc b/modules/customizing-the-appearance/proc-enabling-localization-in-rhdh.adoc index e96ae79086..d1a23b256a 100644 --- a/modules/customizing-the-appearance/proc-enabling-localization-in-rhdh.adoc +++ b/modules/customizing-the-appearance/proc-enabling-localization-in-rhdh.adoc @@ -11,6 +11,7 @@ The following languages are supported: * English (en) * French (fr) * Italian (it) +* Japanese (jp) [NOTE] ==== @@ -32,6 +33,7 @@ i18n: - en - fr - it + - jp defaultLocale: en # Optional. Defaults to `en` if not specified. ... ---- diff --git a/modules/customizing-the-appearance/proc-overriding-translations.adoc b/modules/customizing-the-appearance/proc-overriding-translations.adoc index a136e1c8f2..dd9abdacd6 100644 --- a/modules/customizing-the-appearance/proc-overriding-translations.adoc +++ b/modules/customizing-the-appearance/proc-overriding-translations.adoc @@ -101,6 +101,7 @@ i18n: - en - fr - it + - jp defaultLocale: en # Optional. Defaults to `en` if not specified. overrides: # List of JSON translation files applied in order (last file wins). Each file may override/add translations for one or more plugins/locales - /opt/app-root/src/translations/all-translations.json From 305a0d4d8df1d7e30bb055bad57183bb13c598d8 Mon Sep 17 00:00:00 2001 From: deerskindoll Date: Thu, 11 Dec 2025 11:12:04 +0100 Subject: [PATCH 4/6] added Japanese --- .../customizing-the-appearance/proc-select-rhdh-language.adoc | 1 + 1 file changed, 1 insertion(+) diff --git a/modules/customizing-the-appearance/proc-select-rhdh-language.adoc b/modules/customizing-the-appearance/proc-select-rhdh-language.adoc index 1d7bec9c36..ae9e1efe1e 100644 --- a/modules/customizing-the-appearance/proc-select-rhdh-language.adoc +++ b/modules/customizing-the-appearance/proc-select-rhdh-language.adoc @@ -9,6 +9,7 @@ Use the *Appearance* panel to select a language for {product-very-short}. * English (default) * French * Italian +* Japanese .Prerequisites From 9146fecc3567d801ce43ac8a7c148104ce28ad68 Mon Sep 17 00:00:00 2001 From: deerskindoll Date: Fri, 12 Dec 2025 12:33:58 +0100 Subject: [PATCH 5/6] fixed abbreviation --- .../proc-enabling-localization-in-rhdh.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/modules/customizing-the-appearance/proc-enabling-localization-in-rhdh.adoc b/modules/customizing-the-appearance/proc-enabling-localization-in-rhdh.adoc index d1a23b256a..c47e4403e6 100644 --- a/modules/customizing-the-appearance/proc-enabling-localization-in-rhdh.adoc +++ b/modules/customizing-the-appearance/proc-enabling-localization-in-rhdh.adoc @@ -11,7 +11,7 @@ The following languages are supported: * English (en) * French (fr) * Italian (it) -* Japanese (jp) +* Japanese (ja) [NOTE] ==== @@ -33,7 +33,7 @@ i18n: - en - fr - it - - jp + - ja defaultLocale: en # Optional. Defaults to `en` if not specified. ... ---- From 0c438a4577fee0a8c0a433f46fe999ac89c15f51 Mon Sep 17 00:00:00 2001 From: deerskindoll Date: Mon, 15 Dec 2025 12:09:02 +0100 Subject: [PATCH 6/6] fixed abbreviation --- .../proc-overriding-translations.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/modules/customizing-the-appearance/proc-overriding-translations.adoc b/modules/customizing-the-appearance/proc-overriding-translations.adoc index dd9abdacd6..07e9842d16 100644 --- a/modules/customizing-the-appearance/proc-overriding-translations.adoc +++ b/modules/customizing-the-appearance/proc-overriding-translations.adoc @@ -1,4 +1,4 @@ -:_mod-docs-content-type: CONCEPT +:_mod-docs-content-type: PROCEDURE [id="prov-overriding-translations_{context}"] = Overriding translations @@ -101,7 +101,7 @@ i18n: - en - fr - it - - jp + - ja defaultLocale: en # Optional. Defaults to `en` if not specified. overrides: # List of JSON translation files applied in order (last file wins). Each file may override/add translations for one or more plugins/locales - /opt/app-root/src/translations/all-translations.json