mirror of
https://github.com/storytold/texturecraft.git
synced 2026-11-20 06:20:50 +01:00
Arabic text needs a font with Arabic glyphs; egui already shapes it and orders right-to-left runs. The script joins the CJK ones in the lazy fallback fonts: Noto Sans Arabic from craft-fonts (desktop and web, 0.8 MB), else Segoe UI, Tahoma or Arial on Windows, SF Arabic or Geeza Pro on macOS, and Noto Sans Arabic or DejaVu Sans on Linux and FreeBSD. Without any, the picker lists Arabic by its English name, as for CJK. ATTRIBUTION, the localization table (panels keep the left-to-right layout), features, README and roadmap count ten languages.
62 lines
4.4 KiB
Markdown
62 lines
4.4 KiB
Markdown
# Localization
|
|
|
|
TextureCraft's interface text goes through one lookup, `tr("English text")` in
|
|
`crates/ui-egui/src/i18n.rs`: the English string is the key, so English needs no table and a
|
|
missing translation falls back to English. Each language is a static `(English, translation)`
|
|
table in `crates/ui-egui/src/i18n/<code>.rs`, indexed into a hash map the first time the
|
|
language is used. Text with values uses `trf("Saved {path}", &[("path", &p)])`; static labels
|
|
that are translated where they are shown are marked with `n_("…")`.
|
|
|
|
Pick the language in **Edit ▸ Settings ▸ Language** (it switches live). The first run follows
|
|
the operating system's language (the browser's in the web build).
|
|
|
|
## Status
|
|
|
|
UI strings: every `tr`/`trf`/`n_` literal in `crates/ui-egui/src` plus the menu catalog, panel
|
|
names, shortcut editor rows and the engine's channel, blend mode, mesh map, tool, procedural,
|
|
generator, filter and brush alpha names (**KEYS** strings, counted by the
|
|
`every_key_is_translated_in_every_language` test, which fails when one is missing).
|
|
|
|
| Language | Code | UI strings | Dialogs, tooltips, help | Script support | Native review | Status | To `full` |
|
|
|---|---|---|---|---|---|---|---|
|
|
| English | `en` | KEYS (100%) | yes | Latin | yes | full | 0 h |
|
|
| Simplified Chinese | `zh-Hans` | KEYS (100%) | yes | CJK glyphs: craft-fonts (Noto Sans CJK SC) or system fonts on desktop; see below | no | full | 2 h (review) |
|
|
| Spanish | `es` | KEYS (100%) | yes | Latin | no | full | 1 h (review) |
|
|
| Hindi | `hi` | 0 | no | Devanagari shaping: not yet (egui has no complex shaping) | no | none | 12 h |
|
|
| Arabic | `ar` | KEYS (100%) | yes | Arabic glyphs: craft-fonts (Noto Sans Arabic) or system fonts on desktop; egui shapes the text and orders it right to left (panels keep the left-to-right layout) | yes | full | 0 h |
|
|
| French | `fr` | KEYS (100%) | yes | Latin | no | full | 1 h (review) |
|
|
| Portuguese (Brazil) | `pt-BR` | KEYS (100%) | yes | Latin | no | full | 1 h (review) |
|
|
| Indonesian | `id` | 0 | no | Latin | no | none | 3 h |
|
|
| Japanese | `ja` | KEYS (100%) | yes | CJK glyphs: craft-fonts (BIZ UDPGothic) or system fonts on desktop | no | full | 2 h (review) |
|
|
| German | `de` | KEYS (100%) | yes | Latin | no | full | 1 h (review) |
|
|
| Korean | `ko` | KEYS (100%) | yes | Hangul glyphs: system fonts on desktop (craft-fonts has no Korean face yet) | no | full | 2 h (review) |
|
|
| Vietnamese | `vi` | 0 | no | Latin with diacritics | no | none | 3 h |
|
|
| Italian | `it` | KEYS (100%) | yes | Latin | no | full | 1 h (review) |
|
|
|
|
Not translated on purpose: asset library names (materials, smart masks, alphas, environments),
|
|
user content (layer, texture set, project names), file format and technical names (sRGB8, L16F,
|
|
RGB, OpenGL, DirectX), and error details that come from the engine (shown after a translated
|
|
"Couldn't …:" prefix).
|
|
|
|
## Fonts for Chinese, Japanese, Korean and Arabic
|
|
|
|
egui's built-in fonts have no CJK or Arabic glyphs. `crates/ui-egui/src/fonts.rs` adds fallbacks after the
|
|
app's own fonts (Latin text and row heights keep the default font), loading them only when the
|
|
UI language needs them or the language picker shows every language's own name:
|
|
|
|
1. **craft-fonts** ([storytold/craft-fonts](https://github.com/storytold/craft-fonts)), embedded at
|
|
build time when `CRAFT_FONTS_DIR` points at a checkout (`crates/ui-egui/build.rs`, the recipe in
|
|
craft-fonts' `docs/integration.md`; `CRAFT_FONTS_REQUIRED=1` makes it mandatory for releases).
|
|
Desktop builds embed BIZ UDPGothic Regular (Japanese), Noto Sans CJK SC Regular (Simplified
|
|
Chinese) and Noto Sans Arabic Regular; the web build embeds BIZ UDPGothic (about 4.5 MB of the
|
|
download) and Noto Sans Arabic (0.8 MB).
|
|
2. **System fonts** on desktop: Yu Gothic / Meiryo, Microsoft YaHei / SimSun and Malgun Gothic on
|
|
Windows; Hiragino, PingFang / STHeiti and Apple SD Gothic Neo on macOS; Noto Sans CJK, WenQuanYi,
|
|
Droid Sans Fallback and Nanum Gothic on Linux and FreeBSD. Arabic: Segoe UI / Tahoma / Arial on
|
|
Windows, SF Arabic / Geeza Pro on macOS, Noto Sans Arabic or DejaVu Sans on Linux and FreeBSD.
|
|
|
|
**Web limitation:** a browser page can't read system fonts, so the web build shows CJK text only
|
|
with the fonts it embeds: Japanese (and most shared Han characters) and Arabic when built with
|
|
craft-fonts, none without it. A language no available font can draw appears in the picker under its English
|
|
name and can't be selected.
|