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..b8876bb48a 100644 --- a/modules/customizing-the-appearance/proc-customize-rhdh-language.adoc +++ b/modules/customizing-the-appearance/proc-customize-rhdh-language.adoc @@ -3,16 +3,19 @@ [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 +* Japanese -[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 +26,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..c47e4403e6 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,26 @@ [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) +* Japanese (ja) + +[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 +32,8 @@ i18n: locales: # List of supported locales. Must include `en`, otherwise the translation framework will fail to load. - en - fr + - it + - ja 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..dd9abdacd6 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. @@ -99,6 +100,8 @@ i18n: locales: # List of supported locales. Must include `en`, otherwise the translation framework will fail to load. - 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 @@ -117,4 +120,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..ae9e1efe1e 100644 --- a/modules/customizing-the-appearance/proc-select-rhdh-language.adoc +++ b/modules/customizing-the-appearance/proc-select-rhdh-language.adoc @@ -3,19 +3,22 @@ [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 +* Japanese .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[]