localization-ka.md
# Georgian localization and terminology
This note goes with the Georgian catalog (`crates/ui-egui/src/i18n/ka.tsv`). It covers every key
`cargo xtask i18n-coverage` measures and the runtime labels the other complete catalogs carry
(filter and adjustment parameters, Camera Raw, panels, dialogs, status messages). Translations are
written from the meaning of PhotoCraft's English labels; no proprietary translation resources,
fonts, screenshots or user documents are included.
## Choosing Georgian
Open **Edit > Preferences > Interface > Language** (Georgian: **แ แแแแฅแขแแ แแแ โบ แแแ แแแแขแ แแแ โบ
แแแขแแ แคแแแกแ โบ แแแ**) and choose **แฅแแ แแฃแแ**. With `interface.language` set to `auto`, the system
locales `ka`, `ka-GE` and `ka_GE.UTF-8` resolve to Georgian.
## Register and style
Commands are verbal nouns (masdar: *แจแแแแฎแแ*, *แแแฎแกแแ*, *แจแ แแก แฌแแจแแ*), not imperatives; prompts
and hints address the user politely (*แแแฌแแแแแ*, *แแแแแแแ แแแ*). Product and technology names
(PhotoCraft, OpenType, CMYK, Lab) stay as they are, and the trailing `โฆ` of dialog commands is kept.
## Georgian script
- Mkhedruli has no letter case, so nothing is capitalised and labels never use Mtavruli.
The text engine's **All Caps** maps Mkhedruli to Mtavruli through Unicode `to_uppercase`, which
is the Unicode-standard behaviour; there is no title-case feature that needs a Georgian guard.
- Nouns stay singular after a numeral, so the catalog uses one plural form and count-neutral
wording: `{n} layers` is `แจแ แ: {n}` (`plural_none` in the registry).
- UI font: PhotoCraft bundles no Georgian face. The fallback list in `crates/text/src/scripts.rs`
uses system fonts: Noto Sans Georgian, Segoe UI, Sylfaen, DejaVu Sans and
FreeSans. The web build has no system fonts, so it needs a Georgian face before Georgian can render
there.
- PhotoCraft has no per-language date or number formatting, so nothing Georgian-specific applies.
## Terminology
Follow this table when adding or changing Georgian strings.
| English source | Georgian | Note |
|---|---|---|
| File / Edit / Select / View / Window | แคแแแแ / แ แแแแฅแขแแ แแแ / แแแแแจแแแ / แฎแแแ / แคแแแฏแแ แ | menu bar |
| Image | แแแแแกแแฎแฃแแแแ | the edited picture |
| Canvas / Canvas Sizeโฆ | แขแแแ / แขแแแแก แแแแโฆ | |
| Layer / Layers | แจแ แ / แจแ แแแแ | |
| Selection | แแแแแจแแฃแแ | the selected area; the menu is แแแแแจแแแ |
| Layer Mask / Vector Mask | แจแ แแก แแแฆแแแ / แแแฅแขแแ แฃแแ แแแฆแแแ | |
| Clipping Mask | แแแแญแ แแแ แแแฆแแแ | |
| Smart Object | แญแแแแแแ แแแแแฅแขแ | |
| Rasterize | แ แแกแขแ แแ แแแ | |
| Path / Work Path | แขแ แแแฅแขแแ แแ / แกแแแฃแจแแ แขแ แแแฅแขแแ แแ | not แแแแขแฃแ แ |
| Stroke | แแแแขแฃแ แ | outline of a shape or text |
| Channel / Alpha | แแ แฎแ / แแแคแ | |
| Spot Color / Spot Channel | แกแแแข-แคแแ แ / แกแแแข-แคแแ แแก แแ แฎแ | |
| Adjustments | แแแ แแฅแชแแ | |
| Blend Mode / Blending Options | แจแแ แแแแก แ แแแแแ / แจแแ แแแแก แแแ แแแแขแ แแแ | |
| Opacity | แแแฃแแญแแแ แแแแแแ | |
| Preset / Presets | แแ แแกแแขแ / แแ แแกแแขแแแ | |
| Pattern | แแแขแแ แแ | |
| Swatches | แคแแ แแก แแแแฃแจแแแ | |
| Slice | แแแญแแ แ | |
| Crop | แฉแแแแญแ แ | |
| Feather | แแแแแแแแก แจแแ แแแแแแ | |
| Hue / Lightness | แคแแ แแก แขแแแ / แกแแฆแแแแ | |
| Threshold | แแฆแแแ แ | |
| Brush / Eraser / Smudge | แคแฃแแฏแ / แกแแจแแแแ / แแแแฆแแแแ | |
| Healing Brush | แแฆแแแแแแ แคแฃแแฏแ | |
| Reset | แฉแแแแงแ แ | |
| Paste | แฉแแกแแ | |
| Workspace | แกแแแฃแจแแ แกแแแ แชแ | |
| Foreground / Background Color | แฌแแแ แแแแแแก แคแแ แ / แคแแแแก แคแแ แ | |
## Not covered
Engine error and status messages, user document, layer and preset names, automation command IDs
and the default `Untitled` / `Background` names stay in English, as in every language.
## Maintenance
Add a row to `ka.tsv` for each new English label: `context<TAB>source<TAB>translation`, with
`@plural` rows holding one Georgian form and `@id` rows overriding a command id. Keep `{name}`
placeholders, `\n`, `โฆ` and shortcut text exactly as in the source. Checks:
- `cargo test -p photocraft-ui-egui --lib i18n`: registry, locale tags, placeholders and catalog
consistency.
- `cargo xtask i18n-coverage`: measured key coverage for `ka`.
No file is open. Choose one in the tree, or press Ctrl+O (โO on a Mac) to find one by name.
Syntax highlighting could not load. The unmodified read-only text remains available above.