Internationalization

Xila uses the external embedded-i18n dependency for build-time localization. Core re-exports it as xila::internationalization; the former modules/internationalization crate is no longer in the workspace.

Build-time language selection

Core's .cargo/config.toml selects locale and fallback using EMBEDDED_I18N_LOCALE and EMBEDDED_I18N_FALLBACK. The current configuration chooses English for both. Executables use embedded_i18n::translate! for ordinary and C-string literals and keep translations in their locales/ directories.

The selected translations are embedded in the build. This avoids carrying a dynamic catalog lookup in each runtime call; language choice belongs to the build configuration rather than a live session-language service.

Graphics assets and translation tooling

The font generator uses the selected locale and fallback's character ranges from embedded-i18n to generate the required glyphs. Locale choice therefore also affects generated graphics assets and their size.

Tolgee extraction and synchronization are configured in tolgee.config.ts and tolgee.extractor.mjs. The development command reference lists the translation tasks; their implementation remains in Core's Makefile.

Related documentation

• embedded_i18n crate
• src/lib.rs and .cargo/config.toml.
• modules/graphics/fonts_generator/src/main.rs.
• tolgee.config.ts and tolgee.extractor.mjs.
• Graphics.