Skip to main content

Convertidor d’i18n

Converteixi entre més de 32 formats de fitxer d’i18n. Android XML, iOS Strings, XLIFF, PO, JSON, YAML i més. Sense pèrdues quan sigui possible i amb avisos clars de pèrdua de dades quan no ho sigui.

El problema

Cada plataforma utilitza un format de traducció diferent. Android fa servir strings.xml. iOS fa servir .strings i .stringsdict. Les aplicacions web fan servir JSON o YAML. Els traductors i les plataformes TMS necessiten XLIFF o PO. Quan cal compartir cadenes entre plataformes, s’acaba copiant i enganxant entre formats, escrivint scripts d’un sol ús o reestructurant fitxers manualment. És una tasca tediosa, propensa a errors i que deixa de funcionar cada vegada que apareix un format nou.

Un sol projecte mòbil i web pot incloure fàcilment més de 5 formats de fitxer de traducció diferents. Mantenir-los sincronitzats manualment és una batalla perduda.

La solució

i18n-convert és una única eina CLI que converteix entre més de 32 formats de fitxer d’i18n. Detecta automàticament el format d’entrada, conserva tanta estructura com és possible i l’avisa quan una conversió comportaria la pèrdua de dades, com ara els plurals en un CSV.

Terminal
# Auto-detect input format, convert to Android XML
i18n-convert en.json --to android-xml -o strings.xml

# iOS Strings to Gettext PO
i18n-convert Localizable.strings --to po -o messages.po

# XLIFF to Rails YAML
i18n-convert translations.xliff --to yaml-rails -o en.yml

# Pipe to stdout
i18n-convert messages.po --to json

Detecció automàtica

El format d’entrada es detecta automàticament a partir de l’extensió i el contingut del fitxer. No cal especificar cap paràmetre.

Sense pèrdues quan és possible

Les metadades, els comentaris i les formes plurals es conserven quan el format de destinació els admet.

Avisos de pèrdua de dades

Quan una conversió comportaria la pèrdua d’informació, rebrà avisos explícits abans que s’escrigui cap fitxer.

Instal·lació

Instal·li’l mitjançant npm per obtenir la configuració més senzilla, mitjançant Homebrew a macOS o compili’l des del codi font amb Cargo.

Terminal
npm install -g @i18n-agent/i18n-convert
El paquet npm inclou binaris precompilats per a macOS, Linux i Windows. No cal disposar de la cadena d’eines de Rust.

Conversions habituals

La majoria d’equips necessiten repetir unes quantes conversions: de JSON a Android XML per a dispositius mòbils, de PO a JSON per al web i conversions d’anada i tornada amb XLIFF per lliurar fitxers als traductors. A continuació es mostren alguns patrons habituals.

Batch conversion
# Convert all PO files to JSON
for f in locales/*.po; do
  i18n-convert "$f" --to json -o "${f%.po}.json"
done

# Convert entire directory
i18n-convert locales/ --to json --out-dir locales-json/

Formats admesos

i18n-convert admet més de 32 formats de les categories de dispositius mòbils, web, estàndards de localització i intercanvi de dades.

Dispositius mòbils

FormatExtensionFlag
Android XML.xml--to android-xml
iOS Strings.strings--to ios-strings
iOS Stringsdict.stringsdict--to ios-stringsdict
Flutter ARB.arb--to arb

Web

FormatExtensionFlag
JSON (flat).json--to json
JSON (nested).json--to json-nested
YAML.yml--to yaml
YAML (Rails).yml--to yaml-rails
Properties.properties--to properties

Estàndards de localització

FormatExtensionFlag
XLIFF 1.2.xlf--to xliff
XLIFF 2.0.xlf--to xliff-2
Gettext PO.po--to po
Gettext POT.pot--to pot
TMX.tmx--to tmx
TBX.tbx--to tbx

Intercanvi de dades

FormatExtensionFlag
CSV.csv--to csv
TSV.tsv--to tsv
Excel.xlsx--to xlsx

Avisos de pèrdua de dades

No tots els formats són equivalents. XLIFF admet notes, contextos i formes plurals. CSV no n’admet cap. Quan converteixi d’un format ric a un de més senzill, i18n-convert li indicarà exactament què es perdrà.

Terminal
$ i18n-convert plurals.po --to csv
Data loss warnings:
  [ERROR] 3 entries use plurals (not supported by CSV)
Proceed? [y/N]

# Skip prompts
i18n-convert plurals.po --to csv --force

# Preview warnings without writing
i18n-convert plurals.po --to csv --dry-run
Utilitzi sempre --dry-run abans de convertir a un format més senzill en producció. Així veurà tots els avisos sense escriure cap fitxer.

Integració amb la CI

Automatitzi la sincronització de formats al pipeline de CI/CD. Quan canviï el fitxer de traducció d’origen, torni a generar automàticament tots els formats derivats perquè els fitxers per a dispositius mòbils, web i traductors es mantinguin sincronitzats.

.github/workflows/format-sync.yml
# .github/workflows/format-sync.yml
name: Sync Translation Formats
on:
  push:
    branches: [main]
    paths: ['locales/en.json']

jobs:
  sync-formats:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Install i18n-convert
        run: npm install -g @i18n-agent/i18n-convert

      - name: Convert JSON to Android XML
        run: i18n-convert locales/en.json --to android-xml -o android/res/values/strings.xml

      - name: Convert JSON to iOS Strings
        run: i18n-convert locales/en.json --to ios-strings -o ios/en.lproj/Localizable.strings

      - name: Commit synced formats
        run: |
          git config user.name "github-actions"
          git config user.email "[email protected]"
          git add android/ ios/
          git diff --cached --quiet || git commit -m "chore: sync translation formats"
          git push
Combini i18n-convert amb i18n-validate al pipeline de CI. Converteixi primer els formats i, després, validi que tots els fitxers de destinació siguin complets i estiguin ben formats.

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