CLDR-monikkosäännöt: validoi i18n-monikkoluokat eri kielissä
Englannissa on kaksi monikkomuotoa, arabiassa kuusi ja venäjässä neljä. Jos i18n-toteutuksesi käsittelee vain one- ja other-luokat, sovelluksesi on rikkoutunut useimmilla kielillä. Tämä opas selittää CLDR-monikkosäännöt ja niiden validoinnin.
Mitä CLDR-monikkosäännöt ovat?
Unicode CLDR (Common Locale Data Repository) määrittää kuusi monikkoluokkaa: zero, one, two, few, many ja other. Kukin kieli käyttää näiden luokkien osajoukkoa tietyillä lukusäännöillä. Englanti käyttää one-luokkaa täsmälleen luvulle 1 ja other-luokkaa kaikelle muulle. Useimmat kielet ovat kuitenkin monimutkaisempia — väärät monikkomuodot tuottavat kieliopillisesti rikkoutunutta tekstiä, joka saa sovelluksesi vaikuttamaan amatöörimäiseltä.
// English has 2 plural forms: one, other
// "1 item" vs "2 items"
// But many languages have more:
// Arabic: 6 forms (zero, one, two, few, many, other)
// Polish: 3 forms (one, few, other)
// Japanese: 1 form (other)
// Czech: 3 forms (one, few, other)
// If you only provide "one" and "other",
// Arabic and Polish users see broken text.Kuusi monikkoluokkaa
CLDR määrittää täsmälleen kuusi monikkoluokkaa. Kaikki kielet eivät käytä kaikkia kuutta — englanti käyttää vain kahta, arabia kaikkia kuutta. i18n-tiedostojesi on määritettävä kunkin kohdekielen tarvitsemat luokat, tai käyttäjät näkevät kaatumisia, käsittelemättömiä avaimia tai kieliopillisesti virheellistä tekstiä.
// CLDR defines 6 plural categories:
// zero - 0 items (Arabic, Latvian)
// one - 1 item (most languages)
// two - 2 items (Arabic, Welsh)
// few - 2-4 items (Polish, Czech, Russian)
// many - 5-19 items (Arabic, Polish, Russian)
// other - everything else (required for ALL languages)
// Examples by language:
// English: one, other (2 forms)
// French: one, many, other (3 forms)
// Arabic: zero, one, two, few, many, other (6 forms)
// Japanese: other (1 form)
// Polish: one, few, many, other (4 forms)
// Russian: one, few, many, other (4 forms)Kielten monikkoluokat
Pikaviite tavallisten kohdekielten vaatimiin monikkoluokkiin. Käytä sitä määrittäessäsi käännöstiedostojesi monikkomuotoja.
// MISTAKE 1: Only providing "one" and "other"
// en.json
{
"items_one": "{{count}} item",
"items_other": "{{count}} items"
}
// This breaks for Arabic (missing zero, two, few, many)
// MISTAKE 2: Hardcoded plural logic
// WRONG:
const text = count === 1 ? "1 item" : `${count} items`
// This fails for languages where "1" isn't the only "one" form
// MISTAKE 3: Missing "other" category
// "other" is REQUIRED for every language
// Without it, some numbers show raw keys
// MISTAKE 4: Translating plural RULES instead of text
// The CLDR rules (one, few, many) are universal
// Only the TEXT after each rule should be translatedAutomaattinen monikkomuotojen validointi
i18n-validate tarkistaa, että käännöstiedostojesi jokainen monikkoavain määrittää kaikki kohdekielen vaatimat CLDR-luokat. Jos venäjänkielisessä tiedostossa on vain one- ja other-muodot, työkalu merkitsee puuttuvat few- ja many-luokat virheiksi. Suorita se CI:ssä, jotta löydät monikko-ongelmat ennen kuin ne päätyvät käyttäjille.
# Validate plural forms match CLDR requirements
npx i18n-validate --check-plurals \
--source locales/en.json \
--targets 'locales/*.json'
# Output:
# locales/ar.json:
# items: missing plural forms: zero, two, few, many
# Expected: zero, one, two, few, many, other
# Found: one, other
#
# locales/pl.json:
# items: missing plural forms: few, many
# Expected: one, few, many, other
# Found: one, other
# Fix: Add all required forms for each language
# See https://unicode.org/cldr/charts/latest/supplemental/language_plural_rules.htmlICU MessageFormat monikkomuodoille
Suositeltu tapa määrittää monikolliset käännökset on ICU MessageFormat. Se käyttää yhtä merkkijonoa, johon monikkosäännöt on upotettu: {count, plural, one {# item} other {# items}'}. ICU:ta tukevat react-intl, vue-i18n, Angular Transloco, Flutter ja useimmat nykyaikaiset i18n-kehykset.
// ICU MessageFormat handles plurals correctly
// It uses CLDR rules internally
// en.json
{
"items": "{count, plural, one {# item} other {# items}}"
}
// ar.json
{
"items": "{count, plural, zero {لا عناصر} one {عنصر واحد} two {عنصران} few {# عناصر} many {# عنصرًا} other {# عنصر}}"
}
// pl.json
{
"items": "{count, plural, one {# element} few {# elementy} many {# elementów} other {# elementu}}"
}
// ICU also handles ordinals:
{
"ranking": "{pos, selectordinal, one {#st} two {#nd} few {#rd} other {#th}}"
}# Validate ICU message syntax
npx i18n-validate --check-icu \
--source locales/en.json \
--targets 'locales/*.json'
# Catches:
# - Missing plural categories for the target language
# - Syntax errors in ICU messages
# - Mismatched variable names
# - Missing "other" (always required)Kokeile i18n Agent:ia nyt
Pudota käännöstiedostosi tähän
JSON, YAML, PO, XML, CSV, Markdown, Properties
tai valitse napsauttamalla
Kohdekielet