mirror of
https://github.com/storytold/cadcraft.git
synced 2026-10-24 10:56:51 -06:00
Wladmir JúniorandClaude Opus 5.5
235ef4f9ab
Squash of PR #539 by @WladmirJunior. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
69 lines
4.2 KiB
Markdown
69 lines
4.2 KiB
Markdown
# Interface languages
|
|
|
|
Choose **Edit → Interface Language** and select **Auto (system language)**, **English**,
|
|
**Українська**, or **Português (Brasil)**. The interface updates without restarting, including the native macOS menus.
|
|
The choice is saved with the other interface preferences (`cadcraft.prefs`, beside the theme):
|
|
eframe storage on the desktop, browser local storage on the web. Installations without a saved
|
|
choice use Auto.
|
|
|
|
Auto uses the first supported language in the operating system's preferred locales, or the
|
|
browser's `navigator.languages` on the web. Ukrainian tags such as `uk-UA` and `uk_UA.UTF-8`
|
|
resolve to `uk`, and Portuguese tags such as `pt-BR` and `pt_BR.UTF-8` resolve to `pt-BR`;
|
|
unsupported languages fall back to English. Set `CADCRAFT_LOCALE=uk-UA` to
|
|
override the desktop's locale for a launch. An explicit saved English, Ukrainian or Brazilian Portuguese choice
|
|
takes precedence over that override.
|
|
|
|
Automation can select the language through the existing control channel:
|
|
|
|
```json
|
|
{"id":1,"method":"engine.execute","params":{"command":"ui.language","params":{"lang":"uk"}}}
|
|
```
|
|
|
|
The `ui.set` method also accepts `{"interfaceLanguage":"uk"}`. Supported values are `auto`,
|
|
`en`, `uk`, and `pt-BR`; invalid values are rejected without changing the current selection. Resetting
|
|
palettes keeps the language choice.
|
|
|
|
## Translation coverage
|
|
|
|
The Ukrainian and Brazilian Portuguese catalogs cover command and menu labels, tool groups and tooltips, the Start page, file and
|
|
model-space tabs, status controls, object snaps, drafting prompts, property labels, dialogs,
|
|
and the About window's controls. The command reference can be searched by English command
|
|
ID, English label, or translated label.
|
|
|
|
Drawing titles, layer/layout/block/style names, parameter names and expressions, text in a
|
|
drawing, and command-line input are user data and retain their original spelling. Clickable
|
|
command keywords retain their English spelling so the text shown matches the input accepted
|
|
by the engine. CLI/MCP/control responses, engine diagnostics and command history remain
|
|
English. Uncatalogued text also falls back to English. Number formatting and the operating
|
|
system's own file-picker controls follow the existing behavior.
|
|
|
|
The bundled egui fonts cover Ukrainian, including `Ґґ Єє Іі Її`; the translation adds no font
|
|
assets and works on the web without system fonts.
|
|
|
|
## Adding translations
|
|
|
|
The implementation follows the display-time catalog pattern used by
|
|
[VectorCraft #205](https://github.com/storytold/vectorcraft/pull/205),
|
|
[PdfCraft #106](https://github.com/storytold/pdfcraft/pull/106), and
|
|
[FilmCraft #238](https://github.com/storytold/filmcraft/pull/238). Its code is local to CADCraft.
|
|
|
|
- `crates/ui-egui/src/i18n/uk.tsv` and `pt_br.tsv` are UTF-8 with three tab-separated columns:
|
|
`context`, `English source`, and `translation`. Ordinary labels have an empty context.
|
|
`@plural` entries hold the language's plural forms for integer counts: Ukrainian
|
|
`one|few|many`, Brazilian Portuguese `one|other` (0 and 1 are `one`).
|
|
- Register a new catalog in `i18n::LANGUAGES`, add its preference variant and code/name,
|
|
and set its integer plural rule and form count on the `Language` row.
|
|
- Use `crate::tl!("English label")` for a literal, `i18n::t(label)` for a known dynamic UI
|
|
label, and `crate::tf!("Version {version}", version = value)` for named placeholders.
|
|
Translate only at the display boundary; never look up arbitrary user names or identifiers.
|
|
- Windows retain explicit IDs based on their English source, and tool groups retain their
|
|
source names as keys, so switching languages preserves their state.
|
|
- Catalogs are embedded and parsed once. Missing or malformed rows cannot crash the app;
|
|
tests reject invalid rows, duplicate keys, changed placeholders, and mismatched ellipses.
|
|
- `cargo test -p cadcraft-ui-egui i18n` checks menu/command/tool/snap coverage, every marked
|
|
UI literal, locale resolution, preferences, integer plurals, bundled glyphs and an actual
|
|
English/Ukrainian/English egui render. `cargo xtask ci` runs the workspace quality gates.
|
|
|
|
Translations are original work under `MIT OR Apache-2.0`, written from the meaning of
|
|
CADCraft's English strings. Do not copy proprietary localization resources.
|