Katere oblike prevajalskih datotek podpira i18n-convert?

i18n-convert podpira več kot 32 oblik, vključno z Android XML (strings.xml), iOS Strings (.strings), iOS Stringsdict (.stringsdict), Flutter ARB, JSON (ravni in ugnezdeni), YAML, Rails YAML, XLIFF 1.2 in 2.0, Gettext PO/POT, TMX, TBX, Java Properties, CSV, TSV in Excel (.xlsx).

Ali bom pri pretvarjanju med oblikami izgubil podatke?

Odvisno je od para oblik. Pretvarjanje med enako izraznimi oblikami, na primer JSON in YAML ali XLIFF 1.2 in 2.0, je brez izgub. Pri pretvarjanju bogate oblike v preprostejšo, na primer PO z množinskimi oblikami v CSV, se podatki izgubijo. i18n-convert Vas opozori na vsak podatek, ki bi bil izgubljen, in omogoči preklic z --dry-run.

Ali lahko pretvorim več datotek hkrati?

Da. Namesto posamezne datoteke posredujte imenik in i18n-convert bo obdelal vse prepoznane prevajalske datoteke v njem. Izhodni imenik določite z --out-dir. Za več nadzora nad poimenovanjem posameznih datotek lahko uporabite tudi zanke lupine.

Kako vključim i18n-convert v svoj pipeline CI/CD?

V okolju CI ga namestite prek npm, nato dodajte korak, ki po spremembi izvornih prevajalskih datotek zažene i18n-convert. Z --force preskočite interaktivne pozive v CI. Združite ga z i18n-validate in preverite, ali so pretvorjene datoteke popolne in pravilno oblikovane.

Pretvornik i18n

Name: i18n Agent
Price: 0.01 EUR
Author: i18n Agent

Pretvarjajte med več kot 32 oblikami datotek i18n: Android XML, iOS Strings, XLIFF, PO, JSON, YAML in drugimi. Kjer je mogoče brez izgub, sicer z jasnimi opozorili o izgubi podatkov.

Težava

Vsaka platforma uporablja drugo prevajalsko obliko. Android uporablja strings.xml. iOS uporablja .strings in .stringsdict. Spletne aplikacije uporabljajo JSON ali YAML. Prevajalci in platforme TMS želijo XLIFF ali PO. Ko morate nize deliti med platformami, jih kopirate med oblikami, pišete enkratne skripte ali ročno preurejate datoteke. To je zamudno, nagnjeno k napakam in se pokvari ob vsaki novi obliki.

En sam mobilni in spletni projekt lahko zlahka vključuje več kot 5 različnih oblik prevajalskih datotek. Ročno usklajevanje je izgubljena bitka.

Rešitev

i18n-convert je enotno orodje CLI, ki pretvarja med več kot 32 oblikami datotek i18n. Samodejno zazna vhodno obliko, ohrani čim več strukture in Vas opozori, kadar bi pretvorba izgubila podatke, na primer množinske oblike v 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

Samodejno zaznavanje

Vhodna oblika se samodejno zazna iz pripone datoteke in vsebine. Zastavice niso potrebne.

Brez izgub, kjer je mogoče

Metapodatki, komentarji in množinske oblike se ohranijo, kadar jih ciljna oblika podpira.

Opozorila o izgubi podatkov

Kadar bi pretvorba izgubila podatke, pred zapisom katere koli datoteke prejmete izrecna opozorila.

Namestitev

Za najpreprostejšo nastavitev namestite prek npm, v macOS prek Homebrew ali pa izvorno kodo zgradite s Cargo.

Terminal

npm install -g @i18n-agent/i18n-convert

Paket npm vključuje vnaprej zgrajene binarne datoteke za macOS, Linux in Windows. Veriga orodij Rust ni potrebna.

Pogoste pretvorbe

Večina ekip redno potrebuje nekaj pretvorb: JSON v Android XML za mobilne naprave, PO v JSON za splet in povratne pretvorbe XLIFF za predajo prevajalcem. Spodaj je nekaj pogostih vzorcev.

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/

Podprte oblike

i18n-convert podpira več kot 32 oblik v kategorijah mobilnih in spletnih rešitev, lokalizacijskih standardov ter izmenjave podatkov.

Mobilne rešitve

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

Splet

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

Lokalizacijski standardi

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

Izmenjava podatkov

Format	Extension	Flag
CSV	.csv	--to csv
TSV	.tsv	--to tsv
Excel	.xlsx	--to xlsx

Opozorila o izgubi podatkov

Vse oblike niso enakovredne. XLIFF podpira opombe, kontekste in množinske oblike, CSV pa nič od tega. Ko bogato obliko pretvorite v preprostejšo, i18n-convert natančno sporoči, kaj bo izgubljeno.

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

Pred pretvarjanjem v preprostejšo obliko v produkciji vedno uporabite --dry-run. Tako brez zapisovanja datotek vidite vsa opozorila.

Integracija CI

Sinhronizacijo oblik avtomatizirajte v svojem pipeline CI/CD. Ko se izvorna prevajalska datoteka spremeni, samodejno znova ustvarite vse izpeljane oblike, da mobilne, spletne in prevajalske datoteke ostanejo usklajene.

.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

V pipeline CI združite i18n-convert z i18n-validate. Najprej pretvorite oblike, nato preverite, ali so vse ciljne datoteke popolne in pravilno oblikovane.