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.
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.
# 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 jsonDetecció 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.
npm install -g @i18n-agent/i18n-convertConversions 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.
# 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
| Format | Extension | Flag |
|---|---|---|
| Android XML | .xml | --to android-xml |
| iOS Strings | .strings | --to ios-strings |
| iOS Stringsdict | .stringsdict | --to ios-stringsdict |
| Flutter ARB | .arb | --to arb |
Web
| Format | Extension | Flag |
|---|---|---|
| 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ó
| Format | Extension | Flag |
|---|---|---|
| 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
| Format | Extension | Flag |
|---|---|---|
| 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à.
$ 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-runIntegració 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
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 pushProvar i18n Agent ara
Arrossegar aquí el fitxer de traducció
JSON, YAML, PO, XML, CSV, Markdown, Properties
o fer clic per explorar
Idiomes de destinació