feat(i18n): expand supported languages from 31 to 49 with flags and locale formats
Add 18 previously missing language entries to SUPPORTED_LANGUAGES in app/utils/i18n.py so every translation JSON file in frontend/translations/ is properly indexed and served by the language selector: New languages: af, ar, cy, eo, fa, fy, gl, he, ja, kn, ko, li, nds, no, pa, sr, vi, vls Each new language entry includes: - Correct ISO 639-1/639-3 code matching its JSON filename - Native name and display name - Appropriate country/language flag emoji - Locale-specific date and number formatting rules in _LOCALE_FORMATS Also: rename nb "Norwegian" → "Norwegian Bokmål" to distinguish it from no "Norwegian". Update tests/test_i18n.py: - Count assertions: 31 → 49 - Expected code set expanded to all 49 codes - Fix test_unsupported_language_fallback (ja/ko now supported, use xx/yy) Update docs/InternationalizationGuide.md: - Language count: 10 → 49 - Full language table with flags, native names, tiers - Complete file structure listing all 49 JSON files Co-authored-by: christianlouis <361235+christianlouis@users.noreply.github.com>
This commit is contained in:
@@ -1,27 +1,67 @@
|
||||
# Internationalization (i18n) & Localization (l10n) Guide
|
||||
|
||||
DocuElevate supports **10 languages** for its web UI, with automatic browser
|
||||
DocuElevate supports **49 languages** for its web UI, with automatic browser
|
||||
language detection, user-preference persistence, and an AI-powered fallback
|
||||
translator for strings that haven't been manually translated yet.
|
||||
|
||||
## Supported Languages
|
||||
|
||||
| Code | Language | Native Name | Priority |
|
||||
|------|------------|-------------|----------|
|
||||
| `en` | English | English | Tier 1 |
|
||||
| `de` | German | Deutsch | Tier 1 |
|
||||
| `fr` | French | Français | Tier 1 |
|
||||
| `es` | Spanish | Español | Tier 1 |
|
||||
| `it` | Italian | Italiano | Tier 1 |
|
||||
| `pt` | Portuguese | Português | Tier 1 |
|
||||
| `nl` | Dutch | Nederlands | Tier 2 |
|
||||
| `pl` | Polish | Polski | Tier 2 |
|
||||
| `zh` | Chinese | 中文 | Tier 2 |
|
||||
| `ru` | Russian | Русский | Tier 2 |
|
||||
| Code | Language | Native Name | Flag | Priority |
|
||||
|-------|------------------|--------------------|------|----------|
|
||||
| `en` | English | English | 🇬🇧 | Tier 1 |
|
||||
| `de` | German | Deutsch | 🇩🇪 | Tier 1 |
|
||||
| `fr` | French | Français | 🇫🇷 | Tier 1 |
|
||||
| `es` | Spanish | Español | 🇪🇸 | Tier 1 |
|
||||
| `it` | Italian | Italiano | 🇮🇹 | Tier 1 |
|
||||
| `pt` | Portuguese | Português | 🇵🇹 | Tier 1 |
|
||||
| `nl` | Dutch | Nederlands | 🇳🇱 | Tier 2 |
|
||||
| `nb` | Norwegian Bokmål | Norsk bokmål | 🇳🇴 | Tier 2 |
|
||||
| `no` | Norwegian | Norsk | 🇳🇴 | Tier 2 |
|
||||
| `da` | Danish | Dansk | 🇩🇰 | Tier 2 |
|
||||
| `sv` | Swedish | Svenska | 🇸🇪 | Tier 2 |
|
||||
| `fi` | Finnish | Suomi | 🇫🇮 | Tier 2 |
|
||||
| `is` | Icelandic | Íslenska | 🇮🇸 | Tier 2 |
|
||||
| `ga` | Irish | Gaeilge | 🇮🇪 | Tier 2 |
|
||||
| `lb` | Luxembourgish | Lëtzebuergesch | 🇱🇺 | Tier 2 |
|
||||
| `ca` | Catalan | Català | 🏴 | Tier 2 |
|
||||
| `cy` | Welsh | Cymraeg | 🏴 | Tier 2 |
|
||||
| `fy` | Frisian | Frysk | 🇳🇱 | Tier 2 |
|
||||
| `gl` | Galician | Galego | 🇪🇸 | Tier 2 |
|
||||
| `li` | Limburgish | Limburgs | 🇳🇱 | Tier 2 |
|
||||
| `vls` | West Flemish | West-Vlams | 🇧🇪 | Tier 2 |
|
||||
| `nds` | Low German | Plattdüütsch | 🇩🇪 | Tier 2 |
|
||||
| `pl` | Polish | Polski | 🇵🇱 | Tier 3 |
|
||||
| `cs` | Czech | Čeština | 🇨🇿 | Tier 3 |
|
||||
| `sk` | Slovak | Slovenčina | 🇸🇰 | Tier 3 |
|
||||
| `hu` | Hungarian | Magyar | 🇭🇺 | Tier 3 |
|
||||
| `sl` | Slovenian | Slovenščina | 🇸🇮 | Tier 3 |
|
||||
| `hr` | Croatian | Hrvatski | 🇭🇷 | Tier 3 |
|
||||
| `ro` | Romanian | Română | 🇷🇴 | Tier 3 |
|
||||
| `bg` | Bulgarian | Български | 🇧🇬 | Tier 3 |
|
||||
| `el` | Greek | Ελληνικά | 🇬🇷 | Tier 3 |
|
||||
| `et` | Estonian | Eesti | 🇪🇪 | Tier 3 |
|
||||
| `lv` | Latvian | Latviešu | 🇱🇻 | Tier 3 |
|
||||
| `lt` | Lithuanian | Lietuvių | 🇱🇹 | Tier 3 |
|
||||
| `sr` | Serbian | Српски | 🇷🇸 | Tier 3 |
|
||||
| `tr` | Turkish | Türkçe | 🇹🇷 | Tier 4 |
|
||||
| `uk` | Ukrainian | Українська | 🇺🇦 | Tier 4 |
|
||||
| `ru` | Russian | Русский | 🇷🇺 | Tier 4 |
|
||||
| `he` | Hebrew | עברית | 🇮🇱 | Tier 4 |
|
||||
| `ar` | Arabic | العربية | 🇸🇦 | Tier 4 |
|
||||
| `fa` | Persian | فارسی | 🇮🇷 | Tier 4 |
|
||||
| `af` | Afrikaans | Afrikaans | 🇿🇦 | Tier 4 |
|
||||
| `zh` | Chinese | 中文 | 🇨🇳 | Tier 5 |
|
||||
| `ja` | Japanese | 日本語 | 🇯🇵 | Tier 5 |
|
||||
| `ko` | Korean | 한국어 | 🇰🇷 | Tier 5 |
|
||||
| `vi` | Vietnamese | Tiếng Việt | 🇻🇳 | Tier 5 |
|
||||
| `pa` | Punjabi | ਪੰਜਾਬੀ | 🇮🇳 | Tier 5 |
|
||||
| `kn` | Kannada | ಕನ್ನಡ | 🇮🇳 | Tier 5 |
|
||||
| `eo` | Esperanto | Esperanto | 🌍 | Tier 6 |
|
||||
|
||||
> **Tier 1** languages (European priority) have complete, manually-reviewed
|
||||
> translations. **Tier 2** languages have complete translations but may
|
||||
> receive less frequent updates.
|
||||
> **Tier 1** languages (major European) have complete, manually-reviewed
|
||||
> translations. **Tier 2–3** languages have complete translations but may
|
||||
> receive less frequent updates. **Tier 4–5** cover Non-EU European, Middle
|
||||
> Eastern, and Asian languages. **Tier 6** covers constructed languages.
|
||||
|
||||
## How Language Is Detected
|
||||
|
||||
@@ -71,15 +111,54 @@ Translations are stored as flat JSON files in `frontend/translations/`:
|
||||
```
|
||||
frontend/translations/
|
||||
├── en.json # English (base / reference)
|
||||
├── af.json # Afrikaans
|
||||
├── ar.json # Arabic
|
||||
├── bg.json # Bulgarian
|
||||
├── ca.json # Catalan
|
||||
├── cs.json # Czech
|
||||
├── cy.json # Welsh
|
||||
├── da.json # Danish
|
||||
├── de.json # German
|
||||
├── fr.json # French
|
||||
├── el.json # Greek
|
||||
├── eo.json # Esperanto
|
||||
├── es.json # Spanish
|
||||
├── et.json # Estonian
|
||||
├── fa.json # Persian
|
||||
├── fi.json # Finnish
|
||||
├── fr.json # French
|
||||
├── fy.json # Frisian
|
||||
├── ga.json # Irish
|
||||
├── gl.json # Galician
|
||||
├── he.json # Hebrew
|
||||
├── hr.json # Croatian
|
||||
├── hu.json # Hungarian
|
||||
├── is.json # Icelandic
|
||||
├── it.json # Italian
|
||||
├── pt.json # Portuguese
|
||||
├── ja.json # Japanese
|
||||
├── kn.json # Kannada
|
||||
├── ko.json # Korean
|
||||
├── lb.json # Luxembourgish
|
||||
├── li.json # Limburgish
|
||||
├── lt.json # Lithuanian
|
||||
├── lv.json # Latvian
|
||||
├── nb.json # Norwegian Bokmål
|
||||
├── nds.json # Low German (Plattdeutsch)
|
||||
├── nl.json # Dutch
|
||||
├── no.json # Norwegian
|
||||
├── pa.json # Punjabi
|
||||
├── pl.json # Polish
|
||||
├── zh.json # Chinese
|
||||
└── ru.json # Russian
|
||||
├── pt.json # Portuguese
|
||||
├── ro.json # Romanian
|
||||
├── ru.json # Russian
|
||||
├── sk.json # Slovak
|
||||
├── sl.json # Slovenian
|
||||
├── sr.json # Serbian
|
||||
├── sv.json # Swedish
|
||||
├── tr.json # Turkish
|
||||
├── uk.json # Ukrainian
|
||||
├── vi.json # Vietnamese
|
||||
├── vls.json # West Flemish
|
||||
└── zh.json # Chinese
|
||||
```
|
||||
|
||||
Each file is a flat key-value dictionary with dot-notation namespacing:
|
||||
|
||||
Reference in New Issue
Block a user