Localization

Ace (Core) Localization

See this wiki page: https://github.com/daisy/ace/wiki/Localization

Ace (GUI) Localization

The currently-supported languages are:

• English (credits @marisademeglio @rdeltour @danielweck)
• French (credits @danielweck @rdeltour)
• Spanish (credits @nvdaes)
• ((Pending)) Portuguese-Brazil (credits @thiagoeec)

Updating Existing Localization Resources / Contributing New Languages

In both cases, GitHub Pull Requests must be created in order to propose edits to the JSON resources that contain the translated labels. The Ace GUI locales are:

https://github.com/daisy/ace-gui/tree/master/src/shared/l10n/locales

...please, also update the name of the language itself in this file:

https://github.com/daisy/ace-gui/blob/master/src/shared/l10n/localize.js

Utilities

Under the hood, Ace GUI utilizes the i18next library in order to handle the localization resources at runtime (i.e. JSON files). There are a number of utilities that can ease the process of comparing language keys / values, detecting missing entries, etc.:

https://www.i18next.com/overview/plugins-and-utils