How to internationalize our programs?

[thunderstorm010]

No description provided.

[cmyr]

This is tricky. There is support for localization, but there is not currently any support for bundling localization resources with your program.

There is a mechanism by which you can kind of make this work, though, by manually instantiating your own L10nManager that points to a specific set of string files; take a look in druid/src/localization.rs to get a sense of how this works.

This does not handle other aspects of internationalization, such as number or date formatting, which is firmly in the "one day" category.

[changhe3]

But everything in druid/src/localization.rs other than LocalizedString are private. We cannot use any of them.

[changhe3]

Currently it seems you can only use LocalizedString::with_args to build your localization manually. You probably need to reinvent wheels again by yourself if you want to have something ergonomic to work with.

[cmyr]

Localization is based on the fluent project. You create localization files as described there, and then you can pass your custom resources in when starting your app, with AppLauncher::localization_resources.

There might be some more information in #1528.

[zbraniecki]

hi all, we finished first revision of the higher level API based on FluentBundle - it's in fluent-fallback and binds with l10nregistry-rs. I documented the resource manager here: #397 (comment)

For Localization class you may explore how we structure the "generic" one - https://searchfox.org/mozilla-central/source/dom/webidl/Localization.webidl and then extend for DOM bindings needs for our UI - https://searchfox.org/mozilla-central/source/dom/webidl/DOMLocalization.webidl

I also recommend my notes on how I believe UI should generally hook in localization bindings - raphlinus/crochet#7 and unicode-org/message-format-wg#118

The latter comes from a Unicode WG where we work on standardization of MessageFormat 2.0 which hopefully will be a straight superset of Fluent and we'll provide automated migration tools and the higher level APIs should work without changes.

[cmyr]

Thanks @zbraniecki, will take a look!