Language: Deutsch · English
Translator
Custom translators for localization – TranslatorFactory, ServiceLoader and JSON configuration.
REFERENZ DEVELOPER UPDATED: JUL 2026 APPLIES TO NUCLOS 4.2026.X
On this page
With Nuclos 4.2025.15, a localization mechanism was added that allows additional languages beyond the fixed system locales (de-DE, en-GB). It translates all relevant application texts (not data). These texts can be translated automatically – this requires a Translator implementation as an extension.
TranslatorFactory
A TranslatorFactory produces the translator instances and registers itself with the system. Nuclos finds factories via the Java ServiceLoader; therefore a file META-INF/services/org.nuclos.api.l10n.TranslatorFactory with the factory's FQN must be provided.
Configuration
Configuration is done flexibly via JSON (no structural requirements). A localization's JSON takes precedence over the one on the translator and overrides it completely when an instance is built for that localization.
Example & DeepL
An example (DeepL translator) is in the Nuclos repository. The productive DeepL setup is described in the administration; see also localization/interface languages.
Related pages
Überblick
Inhalte