Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -273,4 +274,4 @@ jest.mock("../hooks/useTranslation", () => ({
}));

// Your test code...
----
----
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand All @@ -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[]
image::rhdh/customize-language-dropdown.png[]
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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.
...
----
...
----
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down Expand Up @@ -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
Expand All @@ -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]
// * xref:proc-enabling-localization-in-sidebar-menu-items_{context}[fggdsg]
Original file line number Diff line number Diff line change
Expand Up @@ -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[]
image::rhdh/customize-language-dropdown.png[]