[
https://issues.apache.org/jira/browse/DOXIASITETOOLS-271?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Herve Boutemy updated DOXIASITETOOLS-271:
-----------------------------------------
Description:
The current locale setup has its flaws:
* It forces you assume that the default locale is English which leads to
problems that {{site_en.xml}} is often not found
* Full locale cannot be used to create a localized site: only language is used,
no country nor region: region is critical for example for Simplified chinese vs
Traditional, see MSITE-904
This overhaul will implement two changes:
# The default locale will not be English anymore, but rather {{ROOT}} as a
language-agnostic one.
# One can provide a full locale and Doxia Sitetools will incrementally reduce
the locale from variant down to root to find the most specific site descriptor,
e.g., {{'de_DE_BY', 'de_DE', 'de', ''}}. Assuming that the user has requested
{{'de_DE_BY'}} as in German in Germany, specifically in Bavaria.
Both approaches apply the logic from
[{{ResouceBundle#getBundle()}}|https://docs.oracle.com/javase/8/docs/api/java/util/ResourceBundle.html#getBundle-java.lang.String-java.util.Locale-java.lang.ClassLoader-].
was:
The current locale setup has its flaws:
* It forces you assume that the default locale is English which leads to
problems that {{site_en.xml}} is often not found
* Full locale cannot be used to create a localized site: only language is used,
no country nor region: region is critical for
This overhaul will implement two changes:
# The default locale will not be English anymore, but rather {{ROOT}} as a
language-agnostic one.
# One can provide a full locale and Doxia Sitetools will incrementally reduce
the locale from variant down to root to find the most specific site descriptor,
e.g., {{'de_DE_BY', 'de_DE', 'de', ''}}. Assuming that the user has requested
{{'de_DE_BY'}} as in German in Germany, specifically in Bavaria.
Both approaches apply the logic from
[{{ResouceBundle#getBundle()}}|https://docs.oracle.com/javase/8/docs/api/java/util/ResourceBundle.html#getBundle-java.lang.String-java.util.Locale-java.lang.ClassLoader-].
> Overhaul locale support (make Locale#ROOT instead of Locale#ENGLISH default
> and use full locale)
> ------------------------------------------------------------------------------------------------
>
> Key: DOXIASITETOOLS-271
> URL: https://issues.apache.org/jira/browse/DOXIASITETOOLS-271
> Project: Maven Doxia Sitetools
> Issue Type: Improvement
> Components: Integration Tools, Site renderer
> Reporter: Michael Osipov
> Assignee: Michael Osipov
> Priority: Major
> Fix For: 2.0.0-M4
>
>
> The current locale setup has its flaws:
> * It forces you assume that the default locale is English which leads to
> problems that {{site_en.xml}} is often not found
> * Full locale cannot be used to create a localized site: only language is
> used, no country nor region: region is critical for example for Simplified
> chinese vs Traditional, see MSITE-904
> This overhaul will implement two changes:
> # The default locale will not be English anymore, but rather {{ROOT}} as a
> language-agnostic one.
> # One can provide a full locale and Doxia Sitetools will incrementally reduce
> the locale from variant down to root to find the most specific site
> descriptor, e.g., {{'de_DE_BY', 'de_DE', 'de', ''}}. Assuming that the user
> has requested {{'de_DE_BY'}} as in German in Germany, specifically in Bavaria.
> Both approaches apply the logic from
> [{{ResouceBundle#getBundle()}}|https://docs.oracle.com/javase/8/docs/api/java/util/ResourceBundle.html#getBundle-java.lang.String-java.util.Locale-java.lang.ClassLoader-].
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
