d543ba5b56
- the prio of messages is now as follows for all themes (RL = realm localization, T = Theme i18n files): RL <variant> > T <variant> > RL <region> > T <region> > RL <language> > T <language> > RL en > T en
- centralize the message resolving logic in helper methods in LocaleUtil and use it for all themes, add unit tests in LocaleUtilTest
- add basic integration tests to check whether realm localization can be used in all supported contexts:
- Account UI V2: org.keycloak.testsuite.ui.account2.InternationalizationTest
- Login theme: LoginPageTest
- Email theme: EmailTest
- deprecate the param useRealmDefaultLocaleFallback=true of endpoint /admin/realms/{realm}/localization/{locale}, because it does not resolve fallbacks as expected and is no longer used in admin-ui v2
- fix locale selection in DefaultLocaleSelectorProvider that a supported region (like "de-CH") will no longer selected instead of a supported language (like "de"), when just the language is requested, add corresponding unit tests
- improvements regarding message resolving in Admin UI V2:
- add cypress test i18n_test.spec.ts, which checks the fallback implementation
- log a warning instead of an error, when messages for some languages/namespaces cannot be loaded (the page will probably work with fallbacks in that case)
Closes #15845
|
||
|---|---|---|
| .. | ||
| .github/workflows | ||
| aggregation | ||
| api_documentation | ||
| authorization_services | ||
| dist | ||
| header-maven-plugin | ||
| internal_resources | ||
| release_notes | ||
| securing_apps | ||
| server_admin | ||
| server_development | ||
| tests | ||
| topics/templates | ||
| upgrading | ||
| .asciidoctorconfig | ||
| .gitattributes | ||
| .gitignore | ||
| .vale.ini | ||
| build-auto.sh | ||
| get-version.sh | ||
| License.html | ||
| pom.xml | ||
| README.md | ||
| release-details | ||
Keycloak Documentation
Open Source Identity and Access Management for modern Applications and Services.
For more information about Keycloak visit the Keycloak homepage and Keycloak blog.
Contributing to Keycloak Documentation
See our Contributor's Guide. The directory also includes a set of templates and other resources to help you get started.
If you want to file a bug report or tell us about any other issue with this documentation, you are invited to please use our issue tracker.
Building Keycloak Documentation
Ensure that you have Maven installed.
First, clone the Keycloak repository:
git clone https://github.com/keycloak/keycloak.git
cd keycloak/docs/documentation
If you are using Windows, you need to run the following command with administrator privilege because this project uses symbolic links:
git clone -c core.symlinks=true https://github.com/keycloak/keycloak.git
To build Keycloak Documentation run:
mvn clean install -am -pl docs/documentation/dist -Pdocumentation
Or to build a specific guide run:
mvn clean install -pl docs/documentation/GUIDE_DIR -Pdocumentation
By default, an archive version of the documentation is built. To build the latest build run:
mvn clean install ... -Platest,documentation
You can then view the documentation by opening docs/documentation/GUIDE_DIR/target/generated-docs/index.html.