Validador d’i18n
Analitzi fitxers de traducció per detectar claus que falten, marcadors de posició malmesos i incoherències en els plurals. Una ordre. 9 comprovacions. 32 formats. Cap configuració.
El problema
Els problemes de traducció són invisibles fins que els usuaris se’ls troben. Una clau que falta mostra una ruta sense processar com ara "settings.billing.title" en lloc d’un text real. Un marcador de posició malmès mostra "{price}" com a text literal en lloc de "$9.99". Un plural mal format provoca una fallada quan el recompte és zero. Aquests errors passen desapercebuts en la revisió del codi perquè ningú no compara manualment 15 fitxers de configuració regional.
Missing keys
Blank text or key paths shown to users
Broken placeholders
{price} displays as literal text instead of $9.99
Orphaned files
Outdated translations confuse the build system
Malformed files
Runtime crashes when users switch languages
La solució
i18n-validate analitza tots els seus fitxers de traducció d’una sola passada. Detecta automàticament l’estructura de directoris i el format dels fitxers, compara cada llengua amb la de referència i indica exactament què falla i on. Sense connectors, configuració ni codi de proves personalitzat.
| Check | Severity | What it catches |
|---|---|---|
| missing-keys | error | Key exists in reference but is absent in a translation |
| extra-keys | error | Key exists in translation but not in the reference |
| placeholders | error | {price}, {{name}}, %s differ between languages |
| plural-structure | error | Plural forms are malformed or missing required categories |
| missing-languages | error | Expected language has no files or directory |
| orphaned-languages | error | Language files exist but are not in the expected list |
| parse-errors | error | File fails to parse (broken JSON, XML, YAML, etc.) |
| empty-values | warning | Key is present but the translation is an empty string |
| untranslated | warning | Translation is identical to the reference language |
i18n-validate v0.1.0 — validating ./locales
Reference: en (2 files: translation.json, apiTester.json)
Languages: de, ja, fr, es, zh-Hans, pt-BR, ko (7 found, 7 expected)
Layout : directory (auto-detected)
Formats : i18next JSON (auto-detected)
────────────────────────────────────────────────
ERRORS (5)
✗ missing-keys │ translation.json
Key "settings.billing.title"
missing in: ja, ko
✗ placeholders │ translation.json
Key "pricing.total" — expected: {price}, {currency}
de: found {price} only — missing {currency}
────────────────────────────────────────────────
WARNINGS (2)
⚠ empty-values │ translation.json
Key "onboarding.step3.hint"
empty in: de, fr
────────────────────────────────────────────────
5 errors, 2 warnings across 7 languages
✗ Validation failedInstal·lació
Instal·li’l com a eina CLI global amb el gestor de paquets que prefereixi. El paquet npm inclou un binari natiu escrit en Rust: no cal compilar-lo ni instal·lar dependències d’execució.
npm install -g @i18n-agent/i18n-validateÚs
Indiqui a l’eina el directori de configuracions regionals. Detecta automàticament la llengua de referència, l’estructura de directoris i el format dels fitxers. La majoria de projectes no requereixen cap configuració.
# Zero-config validation
i18n-validate ./locales
# JSON output for scripting
i18n-validate ./locales --format json | jq '.summary'
# CI/CD with JUnit XML
i18n-validate ./locales --format junit -o i18n-report.xmlIntegració amb CI/CD
Afegeixi la validació de traduccions al pipeline de sol·licituds d’incorporació. L’eina genera XML de JUnit, que s’integra amb els generadors d’informes de proves de GitHub Actions, els artefactes de GitLab CI i qualsevol sistema de CI compatible amb JUnit.
name: Validate Translations
on:
pull_request:
paths: ['locales/**', 'public/locales/**']
jobs:
validate:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Validate translations
run: npx @i18n-agent/i18n-validate ./locales --format junit -o i18n-report.xml
- uses: dorny/test-reporter@v1
if: always()
with:
name: i18n validation
path: i18n-report.xml
reporter: java-junit--strict to also fail on warnings.Formats admesos
Gràcies a i18n-convert, el validador admet de sèrie 32 formats de fitxer d’i18n. No calen connectors ni configuracions específics per a cada format: l’eina el detecta automàticament a partir de l’extensió i el contingut dels fitxers.
Mobile & Desktop
Android XML, Xcode String Catalog, iOS Strings, iOS Stringsdict, Flutter ARB, Qt Linguist
Web & Frameworks
Structured JSON, i18next JSON, JSON5, HJSON, YAML (Rails), YAML (Plain), JavaScript, TypeScript, PHP/Laravel, NEON
Standards & Exchange
XLIFF 1.2, XLIFF 2.0, Gettext PO, TMX, .NET RESX, Java Properties
Data & Other
CSV, Excel (.xlsx), TOML, INI, SRT Subtitles, Markdown, Plain Text
Configuració
En la majoria de projectes no cal cap configuració. Quan necessiti més control —per sobreescriure la gravetat de les comprovacions, definir les llengües esperades o excloure’n les que encara estan en curs—, creï un fitxer .i18n-validate.toml a l’arrel del projecte.
# .i18n-validate.toml
ref = "en"
expect = ["de", "ja", "fr", "es", "zh-Hans", "pt-BR", "ko"]
[checks]
missing-keys = "error"
extra-keys = "error"
placeholders = "error"
empty-values = "warning"
untranslated = "warning"
[languages.ko]
missing-keys = "warning" # Korean is WIP
[languages.ar]
skip = true # Exclude from validationProvar i18n Agent ara
Arrossegar aquí el fitxer de traducció
JSON, YAML, PO, XML, CSV, Markdown, Properties
o fer clic per explorar
Idiomes de destinació