michael-o commented on issue #1226: URL: https://github.com/apache/maven-site-plugin/issues/1226#issuecomment-3885682779
> > If locales are provided they are explicit and if default is needed it needs to be provided as well. > > I’m having trouble understanding the statement. OK, let's go through: > The term “default” seems ambiguous here, and I’m unsure which of the following meanings is intended: > > 1. A literal "default" token inside the `<locales>` parameter, which would then map to the system default locale. No, "default" means for Maven Doxia Sitetools, not the JVM. Relying on the JVM locale is horribly brittle. System (JVM) default is "system". This is also document. "default" locale is always `Locale#ROOT`. > 2. The system default locale itself, which is generally difficult to change and may not be what the user wants. Correct, see above. > 3. The default site output directory (target/site/), which previously was produced using the first valid locale listed in `<locales>`. Documentation needs to change. > Also, if the current implementation is not meant to change, how would the use case described in this issue be achieved in practice? We have several ITs covering your exact case. It boils down to: `<locales>default,de,fr_CA,ar_SA,pl</locale>` -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
