Files
vectorcraft/docs/localization-hi.md
T
dotCooCoo 1f64044f1c Web: Korean and Hindi interface text draws with real glyphs
The web build had no face for Hangul or Devanagari, so a Korean or Hindi
interface, and a layer or file name in either script, drew as
missing-glyph boxes.

- crates/text/web-fonts.txt gains a `demand` kind: NanumGothic Regular
  and Noto Sans Devanagari Regular are served beside the wasm like the
  other web faces, and fetched only when the interface language or the
  interface's own text needs their script. They are not fetched at
  startup or in the background queue.
- The interface reports the characters no loaded font covers
  (`on_missing_glyphs`), and keeps them so that they are looked for again
  when the font database changes. The frame after a face arrives adds it
  to the interface fonts, and the frame after that draws the characters
  painted before it with that face.
- After a failed fetch the next try comes about 30 seconds later, and the
  wait doubles after each further failure, for at most five tries.
- A new test checks that the two faces cover every Hangul and Devanagari
  character the catalogs use, where craft-fonts has them.

Docs: gaps.md, localization-hi.md, localization-parity.md,
target-app-parity.md.
2026-11-13 05:45:25 -08:00

6.6 KiB
Raw Blame History

Hindi interface terminology and verification

The hi catalog is a machine-assisted Hindi draft written from VectorCraft's English strings. It starts from matching entries in PhotoCraft's clean-room Hindi catalog. VectorCraft's current loanword preferences below take precedence over that starting vocabulary. The remaining drafts used the local Argos English–Hindi 1.1 model, followed by an agent wording pass on commands, vector vocabulary, counted messages, warnings and diagnostic identifiers. The contributor is a native Hindi speaker and approved the loanword preferences below. This records terminology feedback, not an independent native proofread of every row. No proprietary localization resources were used; coverage tests alone do not establish translation quality.

Style

Prefer familiar design-app loanwords, as requested by the contributor: Save is सेव, Save As is सेव ऐज़…, a vector path is पाथ (never पाठ), text is टेक्स्ट, a document is डॉक्यूमेंट, preview is प्रीव्यू and workspace is वर्कस्पेस. The contributor also approved सिलेक्शन, प्रॉपर्टीज़, ऑप्शन्स and ओपन. Keep Hindi sentence structure and auxiliaries; use सेव करें within a sentence. Keep nukta in फ़ाइल/फ़ॉन्ट/ज़ूम and -एँ in हटाएँ/दिखाएँ. Retain ASCII digits, unit symbols, keyboard shortcuts and product/format names. Command IDs, parameter names, enum values and numbers in diagnostics must stay exactly as supplied. Keep fragment edge spaces: the hint bar assembles sentences from separately translated pieces. The built-in workspace and perspective preset names stay in English, as in the other catalogs.

Hindi integer counts use the first plural form for 0 and 1 and the second for 2+ (plural_french). Both @plural and @msgplural rows have two forms. The latter translate status messages when displayed; the engine, control channel and MCP continue to return English messages.

Terminology

English Hindi
Layer / Layers लेयर / लेयर्स
Object ऑब्जेक्ट
Selection / Select सिलेक्शन / सिलेक्ट
Properties / Options / Open प्रॉपर्टीज़ / ऑप्शन्स / ओपन
Shape (vector) शेप
Shape (generic form) आकार
Artboard आर्टबोर्ड
Artwork आर्टवर्क
Path / Anchor point / Handle पाथ / एंकर पॉइंट / हैंडल
File path on disk फ़ाइल पाथ
Fill / Stroke फ़िल / स्ट्रोक
Gradient / Mesh / Blend ग्रेडिएंट / मेश / ब्लेंड
Pattern / Swatch पैटर्न / स्वॉच
Appearance / Graphic style अपीयरेंस / ग्राफ़िक स्टाइल
Symbol / Envelope सिंबल / एन्वेलप
Clipping mask / Opacity mask क्लिपिंग मास्क / ओपेसिटी मास्क
Image Trace / Live Paint इमेज ट्रेस / लाइव पेंट
Shape Builder / Pathfinder शेप बिल्डर / पाथफ़ाइंडर
Kerning / Leading / Tracking कर्निंग / लीडिंग / ट्रैकिंग
Character / Paragraph कैरेक्टर / पैराग्राफ़
Save / Save As सेव / सेव ऐज़…
Document / Text डॉक्यूमेंट / टेक्स्ट
Preferences / Workspace प्रेफ़रेंसेज़ / वर्कस्पेस
Preview / Opacity प्रीव्यू / ओपेसिटी
W / H / X / Y W / H / X / Y

Scope and checks (2026-11-06)

The draft has 7,877 unique rows, including 2,537 @msg, 45 @msgplural and 38 @plural rows. Its source set combines the sibling catalogs with the current test scanner's UI/undo and error message dumps, so it includes runtime labels outside the literal scanner. Row count is not a percentage of the application's entire interface.

The comparison covers release v0.21.1 (f6aa4309) and current main (3c7d9e1f). Their non-English catalogs have no missing Hindi keys except the names deliberately kept in English. A separate scan of the release's tl! literals checks strings beyond its catalogs. Current main added paragraph labels, spine-index validation and two error messages: six rows in total. Main's workspace version is still 0.21.0; this PR does not change release versioning.

cargo test -p vectorcraft-ui-egui --lib i18n::tests passes all 55 tests in Ubuntu 24.04 (WSL). The untranslated report has no Hindi section, meaning it found no missing Hindi rows among the categories it checks. This does not check dynamically assembled strings that the scanners miss. Additional checks compare placeholders, backtick-delimited identifiers and numeric values. The native Hindi UI fallback test also passes with the installed Nirmala UI font. A running desktop preview was checked in Hindi, including the New Document dialog and File menu. The final cargo xtask ci passed all 12 stages in Ubuntu 24.04 (WSL): formatting, workspace clippy, workspace tests, doctests, no-bundled-fonts, PDF dependencies, assets, brands, cursors, the translation report, layers and WebAssembly. The language picker keeps each language's own name, including English; its native-menu regression passed with the final catalog.

Fonts and remaining review

The pinned egui fork shapes Devanagari with HarfRust. The desktop's existing UiFonts loader finds an installed covering face, such as Nirmala UI, Kohinoor Devanagari or Noto Sans Devanagari. If a CRAFT_FONTS_DIR build includes a face tagged Deva, it is also installed at the end of each UI font family. No font binaries are added to this repository. Without either an embedded or installed covering face, Hindi cannot display correctly. The web has no system fonts. A web build made with craft-fonts serves Noto Sans Devanagari Regular beside the wasm and fetches it when the interface language is Hindi or the interface paints Devanagari (crates/text/web-fonts.txt, demand); until it arrives, Devanagari draws as missing-glyph boxes. Other languages do not fetch it.

Before release: native-speaker review of the draft (especially less common labels and error messages), and visual checks for clipped labels and matras at different UI scales, on the desktop and on the web. Reviewers should use this glossary to make terminology corrections consistently.