LightCraft: An open-source non-destructive photo editor written by scratch in pure Rust
docs(i18n): document Vietnamese localization
DUY Tran Nhat (SAE-KIDS)07c8e4e68e23
diff --git a/docs/localization-parity.md b/docs/localization-parity.mdindex 18aae618a..cb6bad495 100644--- a/docs/localization-parity.md+++ b/docs/localization-parity.md@@ -1,12 +1,12 @@# Localization parity-> **Last reviewed:** 2026-10-10 · **Last updated:** 2026-10-10 · **Change:** major (first per-language measurement from the catalogs) · **Target:** Adobe Lightroom Classic 15.5 / Lightroom 9.6+> **Last reviewed:** 2026-10-13 · **Last updated:** 2026-10-13 · **Change:** minor (Vietnamese shipped; denominator remeasured) · **Target:** Adobe Lightroom Classic 15.5 / Lightroom 9.6How far each interface language is from `full`. How to add or maintain a language is in[localization.md](localization.md); per-language notes are in `localization-<code>.md`([zh-hans](localization-zh-hans.md), [zh-hant](localization-zh-hant.md), [ja](localization-ja.md),[pt-br](localization-pt-br.md), [es](localization-es.md), [de](localization-de.md),-[ru](localization-ru.md)).+[ru](localization-ru.md), [vi](localization-vi.md)).## The target@@ -18,12 +18,12 @@ go beyond the target.## How the numbers are measured-**Measured** (a Python count over `crates/ui-egui/locales/*.json`, 2026-10-10):+**Measured** (a Python count over `crates/ui-egui/locales/*.json`, 2026-10-13):-- The denominator is every message any catalog knows: the union of the plain catalogs' keys (2,074+- The denominator is every message any catalog knows: the union of the plain catalogs' keys (2,222English source strings: menus, commands, controls, panels, dialogs, tooltips, presets, What's New- lines) plus the 230 messages of the formats catalogs (`*-formats.json`: text with runtime values and- date patterns), 2,304 messages in all.+ lines) plus the 249 messages of the formats catalogs (`*-formats.json`: text with runtime values and+ date patterns), 2,471 messages in all.- A message counts as translated when the catalog has a non-empty value that differs from the Englishkey. Some identical values are correct (`ISO`, `OK` in German), so the figure slightly understatescoverage; on the other hand, strings that never reach a catalog (technical errors raised in lower@@ -45,26 +45,26 @@ that is promising but is not recorded as review, so the column says `no (communi| # | Language | Code | UI strings translated | Dialogs / tooltips / help | Script support | Native review | Status | To `full` ||---|---|---|---:|---|---|---|---|---:|-| 1 | English | `en` | 2,304 / 2,304 (100%, source) | all; Help ▸ What's New and the shortcut sheet; no full user manual | Latin (Inter) | n/a | **full** | 0 h |-| 2 | Simplified Chinese | `zh-hans` | 1,994 / 2,304 (87%) | menus, panels, dialogs, presets, profiles, dates; lower-layer errors English | Hans via craft-fonts (Noto Sans CJK SC); IME through winit; no vertical text in UI (not in target either) | no (community edits) | partial | 6–10 h |-| 3 | Spanish | `es` | 1,972 / 2,304 (86%) | as zh-hans | Latin | no (community edits) | partial | 6–10 h |+| 1 | English | `en` | 2,471 / 2,471 (100%, source) | all; Help ▸ What's New and the shortcut sheet; no full user manual | Latin (Inter) | n/a | **full** | 0 h |+| 2 | Simplified Chinese | `zh-hans` | 2,223 / 2,471 (90%) | menus, panels, dialogs, presets, profiles, dates; lower-layer errors English | Hans via craft-fonts (Noto Sans CJK SC); IME through winit; no vertical text in UI (not in target either) | no (community edits) | partial | 5–9 h |+| 3 | Spanish | `es` | 2,209 / 2,471 (89%) | as zh-hans | Latin | no (community edits) | partial | 5–9 h || 4 | Hindi | `hi` | 0 (0%) | none | **Devanagari shaping missing** (egui has no complex shaping) | no | none (target: not shipped) | 50–90 h (shaping 25–50 h, shared with Arabic) || 5 | Arabic | `ar` | 0 (0%) | none | **RTL layout and Arabic shaping missing** | no | none (target: not shipped) | 60–110 h (RTL mirroring 30–50 h + shaping, shared with Hindi) |-| 6 | French | `fr` | 2,021 / 2,304 (88%) | as zh-hans | Latin | no (community edits) | partial | 5–9 h |-| 7 | Portuguese (Brazil) | `pt-br` | 1,966 / 2,304 (85%) | as zh-hans | Latin | no (community edits) | partial | 6–10 h |+| 6 | French | `fr` | 2,113 / 2,471 (85%) | as zh-hans | Latin | no (community edits) | partial | 5–9 h |+| 7 | Portuguese (Brazil) | `pt-br` | 2,106 / 2,471 (85%) | as zh-hans | Latin | no (community edits) | partial | 6–10 h || 8 | Indonesian | `id` | 0 (0%) | none | Latin (Inter covers it) | no | none (target: not shipped) | 10–16 h |-| 9 | Japanese | `ja` | 1,995 / 2,304 (87%) | as zh-hans; vertical export watermarks | Jpan via craft-fonts (BIZ UDPGothic / UDMincho); IME through winit | no (community edits) | partial | 6–10 h |-| 10 | German | `de` | 2,104 / 2,304 (91%) | as zh-hans; What's New translated line by line | Latin | no (community edits) | partial | 4–8 h |+| 9 | Japanese | `ja` | 2,097 / 2,471 (85%) | as zh-hans; vertical export watermarks | Jpan via craft-fonts (BIZ UDPGothic / UDMincho); IME through winit | no (community edits) | partial | 6–10 h |+| 10 | German | `de` | 2,210 / 2,471 (89%) | as zh-hans; What's New translated line by line | Latin | no (community edits) | partial | 4–8 h || 11 | Korean | `ko` | 0 (0%) | none | **no Korean (Hangul) face**: needs a non-Adobe OFL face in craft-fonts (Noto CJK is allowed only for Chinese) | no | none | 14–22 h |-| 12 | Vietnamese | `vi` | 0 (0%) | none | Latin with stacked diacritics (Inter covers it; check combining marks) | no | none (target: not shipped) | 10–16 h |+| 12 | Vietnamese | `vi` | 2,471 / 2,471 (100% key coverage of current union; intentional English like `ISO`/`OK` kept) | menus, panels, dialogs, presets, profiles, dates, formats; lower-layer errors English | Latin with stacked diacritics (Inter) | no (community contribution) | **full** (current localizable surface) | 0 h |## Other languages LightCraft ships (3)| Language | Code | UI strings translated | Script | Native review | Status | To `full` ||---|---|---:|---|---|---|---:|-| Traditional Chinese (Taiwan) | `zh-hant` | 1,993 / 2,304 (87%) | Hant; uses the Simplified Chinese face until craft-fonts has a TC face | no (community edits) | partial | 8–14 h (incl. the font) |-| Russian | `ru` | 1,704 / 2,304 (74%) | Cyrillic (Inter) | no (community edits) | partial | 8–12 h |-| Ukrainian | `uk` | 2,287 / 2,304 (99%) | Cyrillic (Inter) | no (community edits) | partial (lower-layer errors English) | 2–4 h |+| Traditional Chinese (Taiwan) | `zh-hant` | 2,095 / 2,471 (85%) | Hant; uses the Simplified Chinese face until craft-fonts has a TC face | no (community edits) | partial | 8–14 h (incl. the font) |+| Russian | `ru` | 2,373 / 2,471 (96%) | Cyrillic (Inter) | no (community edits) | partial | 2–4 h |+| Ukrainian | `uk` | 2,379 / 2,471 (96%) | Cyrillic (Inter) | no (community edits) | partial (lower-layer errors English) | 1–3 h |Target languages LightCraft lacks: Italian, Korean, Dutch, Polish, Swedish, Norwegian Bokmål, Thai(Thai needs shaping and line breaking without spaces). Each Latin-script one is ~10–16 h; Thai@@ -89,4 +89,5 @@ Target languages LightCraft lacks: Italian, Korean, Dutch, Polish, Swedish, Norw| Date | Change | Summary ||---|---|---|+| 2026-10-13 | minor | Remeasured denominator (2,222 plain + 249 formats = 2,471); Vietnamese shipped at full current localizable coverage || 2026-10-10 | major | Created: per-language counts measured from the catalogs, the twelve key languages, script support, estimates |diff --git a/docs/localization-vi.md b/docs/localization-vi.mdnew file mode 100644index 000000000..23eed342a--- /dev/null+++ b/docs/localization-vi.md@@ -0,0 +1,74 @@+# LightCraft bằng tiếng Việt++Chọn **Chỉnh sửa → Ngôn ngữ → Tiếng Việt** hoặc **Cài đặt → Chung → Ngôn ngữ**.+Lựa chọn áp dụng ngay và được lưu cho lần mở sau (`language: "vi"` trong `ui.json`).++Các tag locale hệ thống sau cũng chọn tiếng Việt: `vi`, `vi-VN`, `vi_VN`, `vi_VN.UTF-8`.++## Phạm vi++Catalog tiếng Việt phủ **toàn bộ** bề mặt localization hiện tại của LightCraft+(đo 2026-10-13: union plain **2 222** + formats **249** = **2 471** thông điệp):++- `crates/ui-egui/locales/vi.json` — thông điệp plain / nhãn hiển thị (2 222 khóa)+- `crates/ui-egui/locales/vi-formats.json` — thông điệp có giá trị runtime và mẫu ngày (249 khóa)++Điều này là **100% bề mặt localizable/runtime hiện tại**, không phải “mọi chuỗi tiếng Anh+trong toàn bộ repository”. Lỗi kỹ thuật từ crate tầng dưới vẫn có thể là tiếng Anh, giống+các ngôn ngữ khác.++## Quy ước thuật ngữ++| English | Vietnamese |+|---|---|+| File / Folder | Tệp / Thư mục |+| Library / Album / Smart Album | Thư viện / Album / Album thông minh |+| Import / Export | Nhập / Xuất |+| Exposure / Contrast | Phơi sáng / Tương phản |+| Highlights / Shadows / Whites / Blacks | Vùng sáng / Vùng tối / Vùng trắng / Vùng đen |+| White Balance / Temperature / Tint | Cân bằng trắng / Nhiệt độ / Tint |+| Vibrance / Saturation | Độ rực rỡ / Độ bão hòa |+| Texture / Clarity / Dehaze / Grain / Vignette | Kết cấu / Độ rõ / Khử sương mù / Hạt / Tối góc |+| Tone Curve | Đường cong tông màu |+| Sharpening / Noise Reduction / Denoise | Làm nét / Giảm nhiễu / Khử nhiễu |+| Mask / Brush / Gradient | Mặt nạ / Cọ / Chuyển sắc |+| Preset / Profile / History / Version | Thiết lập sẵn / Hồ sơ / Lịch sử / Phiên bản |+| Appearance (giao diện) | Giao diện |+| Subject (AI) | Chủ thể |+| Candidate / the Select | Ảnh ứng viên / Ảnh được chọn |+| Flag / Picked / Rejected / Unflagged | Gắn cờ / Đã chọn / Đã loại / Không gắn cờ |++Tên sản phẩm và chuẩn giữ nguyên khi là định danh: LightCraft, ArtCraft, GitHub, Discord,+JPEG, PNG, TIFF, WebP, AVIF, HEIF, HEIC, RAW, DNG, RGB, HDR, ICC, EXIF, XMP, GPU, MCP, SAM, ISO, OK.++Tên album / preset / profile do người dùng tạo, tên tệp, command ID và metadata nhập tay+không được dịch.++## Ngày và số lượng++- Ngày đầy đủ: `{weekday}, {day}/{month}/{year}` (ví dụ `Chủ Nhật, 20/9/2026`)+- Tháng/năm: `Tháng {month} năm {year}`+- Thứ viết tắt trên date picker: T2…T7, CN+- Thông điệp đếm dùng dạng trung tính (`22 ảnh`), không tạo số ít/số nhiều nhân tạo như tiếng Anh++## Font++Tiếng Việt dùng Inter (Latin + dấu). Không cần craft-fonts CJK. Kiểm tra glyph trong+`vietnamese_panels_dialogs_and_diacritics_paint_with_bundled_fonts`.++## Kiểm tra++```sh+cargo test -p lightcraft-ui-egui i18n::tests -- --nocapture+LIGHTCRAFT_LANGUAGE=vi lightcraft-cli snapshot --demo -o vi.png --size 1600x1000+LIGHTCRAFT_LANGUAGE=vi lightcraft-cli snapshot --demo -o vi-narrow.png --size 1280x800+```++Các test tiếng Việt bắt buộc phủ catalog union, nhãn lệnh/control/Settings/Smart Album,+đổi ngôn ngữ, lưu `vi`, formats, ngày, dữ liệu người dùng, và glyph dấu.++## Nguồn dịch (clean-room)++Dịch từ chuỗi tiếng Anh nguồn của LightCraft. PhotoCraft / VectorCraft / PDFCraft chỉ dùng+làm bộ nhớ thuật ngữ khi cùng nguồn tiếng Anh và cùng ngữ cảnh UI. Không dùng gói ngôn ngữ+Adobe Lightroom hay tài nguyên độc quyền.diff --git a/docs/localization.md b/docs/localization.mdindex 715b871af..7f40c32fa 100644--- a/docs/localization.md+++ b/docs/localization.md@@ -2,10 +2,13 @@The interface ships in the language it is written in (English) plus every language in the table in`crates/ui-egui/src/i18n.rs`. Today that is English, Simplified Chinese (`zh-hans`), Traditional-Chinese (`zh-hant`, Taiwan), Japanese (`ja`), Brazilian Portuguese (`pt-br`), Spanish (`es`), German (`de`), Russian (`ru`) and French (`fr`). This file is the reference for **adding or maintaining a language**; the per-language notes-are in [`localization-zh-hans.md`](localization-zh-hans.md), [`localization-zh-hant.md`](localization-zh-hant.md),-[`localization-ja.md`](localization-ja.md), [`localization-pt-br.md`](localization-pt-br.md), [`localization-es.md`](localization-es.md),-[`localization-de.md`](localization-de.md) and [`localization-ru.md`](localization-ru.md).+Chinese (`zh-hant`, Taiwan), Japanese (`ja`), Brazilian Portuguese (`pt-br`), Spanish (`es`), German (`de`),+Russian (`ru`), French (`fr`), Ukrainian (`uk`) and Vietnamese (`vi`). This file is the reference for+**adding or maintaining a language**; the per-language notes are in+[`localization-zh-hans.md`](localization-zh-hans.md), [`localization-zh-hant.md`](localization-zh-hant.md),+[`localization-ja.md`](localization-ja.md), [`localization-pt-br.md`](localization-pt-br.md),+[`localization-es.md`](localization-es.md), [`localization-de.md`](localization-de.md),+[`localization-ru.md`](localization-ru.md) and [`localization-vi.md`](localization-vi.md).## Adding a language@@ -30,6 +33,7 @@ are in [`localization-zh-hans.md`](localization-zh-hans.md), [`localization-zh-hDe, "de", "Deutsch", "Latn", include_str!("../locales/de.json");Ru, "ru", "Русский", "Cyrl", include_str!("../locales/ru.json");Uk, "uk", "Українська", "Cyrl", include_str!("../locales/uk.json");+ Vi, "vi", "Tiếng Việt", "Latn", include_str!("../locales/vi.json");}```