Languages¶

RustGIS's interface is available in 17 languages:

Choosing a language¶

By default RustGIS follows the first supported language in your system's preferences (your browser's on the web) and falls back to English. The Chinese catalog is Simplified Chinese; Traditional Chinese locales are not mapped to it. To choose a language yourself, open Settings › Language. The choice is remembered in prefs.json in the desktop app's settings folder, or in browser storage on the web. When following the system language, you can override its detection for one desktop run with RUSTGIS_LANGUAGE:

RUSTGIS_LANGUAGE=de cargo run --release -p rustgis

Only the interface is translated. Your data, layer and field names, command ids and the command line stay as they are, so scripts work in every language.

Chinese, Japanese and Korean need a CJK font. The desktop app uses one you have installed (Noto Sans CJK, Microsoft YaHei, Yu Gothic, Malgun Gothic, PingFang, Hiragino or Apple SD Gothic Neo); the web app downloads Noto Sans from assets.rustgis.app the first time you pick one of these languages. Map labels in images exported from the desktop app and the command line draw CJK text with the same installed font, whatever the interface language. Images exported from the web app have no CJK font yet, so CJK characters are left out of their labels.

Persian needs a font with both Arabic-script and Latin letters. The desktop app uses one you have installed (Segoe UI, Tahoma, Arial, Vazirmatn or DejaVu Sans); the web app downloads Vazirmatn from assets.rustgis.app the first time you pick Persian.

Translating¶

Each non-English language is a UTF-8 catalog of English<TAB>Translation lines in crates/ui-egui/src/i18n/<code>.tsv. English is the source language and has no catalog. Blank lines and lines beginning with # are ignored. Within either field, \n, \t and \\ represent a line break, tab and backslash. A missing entry shows in English, so translations can grow one line at a time, and corrections from native speakers are welcome.

Pull requests can leave new strings out of the catalogs: the maintainer translates them before each release. To translate a new string, add a line with the exact English text, a tab, and the translation. Keep {placeholders} such as {n} or {name} (they may move), keep the line break (\n) in two-line ribbon labels, and leave product, format and key names (RustGIS, GeoJSON, CSV, Ctrl…) in English. To add a language, add its catalog and a row in LANGUAGES in crates/ui-egui/src/i18n/mod.rs. The i18n tests check catalog format and placeholders, and require translations for some established interface strings:

cargo test -p rustgis-ui-egui i18n

Persian text uses the toolkit's script shaping, with Latin runs and brackets adjusted by crates/ui-egui/src/i18n/rtl.rs. Long paragraphs are broken into lines before drawing. Panes and widgets retain their left-to-right layout. Arabic, Hebrew, Hindi and Thai are not included in the language picker.