Skip to main content
Open Source CLI Tool

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ó.

9 checks 32 formats Zero config Native Rust binary

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 majoria d’eines de validació són específiques d’un format (només JSON o només YAML) i requereixen codi de proves personalitzat per a cada projecte. Sovint, els errors de traducció només es detecten durant l’execució, quan els usuaris veuen una interfície amb errors.

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.

CheckSeverityWhat it catches
missing-keyserrorKey exists in reference but is absent in a translation
extra-keyserrorKey exists in translation but not in the reference
placeholderserror{price}, {{name}}, %s differ between languages
plural-structureerrorPlural forms are malformed or missing required categories
missing-languageserrorExpected language has no files or directory
orphaned-languageserrorLanguage files exist but are not in the expected list
parse-errorserrorFile fails to parse (broken JSON, XML, YAML, etc.)
empty-valueswarningKey is present but the translation is an empty string
untranslatedwarningTranslation is identical to the reference language
Terminal output
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 failed

Instal·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ó.

Terminal
npm install -g @i18n-agent/i18n-validate
El paquet npm inclou un binari natiu precompilat per a macOS, Linux i Windows. No cal disposar de la cadena d’eines de Rust.

Ú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ó.

Terminal
# 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.xml

Integració 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.

.github/workflows/validate-i18n.yml
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
The tool exits with code 1 when errors are found, so it naturally fails CI. Use --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
# .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 validation

Provar i18n Agent ara

Arrossegar aquí el fitxer de traducció

JSON, YAML, PO, XML, CSV, Markdown, Properties

o fer clic per explorar

Idiomes de destinació

No cal registrePressupost instantani

Preguntes freqüents