Mitä käännöstiedostomuotoja i18n-convert tukee?

i18n-convert tukee yli 32 muotoa, kuten Android XML (strings.xml), iOS Strings (.strings), iOS Stringsdict (.stringsdict), Flutter ARB, JSON (litteä ja sisäkkäinen), YAML, Rails YAML, XLIFF 1.2 ja 2.0, Gettext PO/POT, TMX, TBX, Java Properties, CSV, TSV ja Excel (.xlsx).

Menetänkö tietoja muotojen välisessä muunnoksessa?

Se riippuu muotoparista. Yhtä ilmaisuvoimaisten muotojen välinen muunnos (JSON YAML-muotoon, XLIFF 1.2 versioksi 2.0) on häviötön. Monipuolisesta muodosta yksinkertaisempaan muuntaminen (monikkomuotoja sisältävä PO CSV-muotoon) menettää tietoa. i18n-convert varoittaa jokaisesta menetettävästä tiedosta ja antaa perua muunnoksen --dry-run-valitsimella.

Voinko muuntaa useita tiedostoja kerralla?

Kyllä. Anna yksittäisen tiedoston sijaan hakemisto, niin i18n-convert käsittelee kaikki sen tunnistamat käännöstiedostot hakemistossa. Määritä tulostehakemisto --out-dir-valitsimella. Voit hallita yksittäisten tiedostojen nimeämistä tarkemmin myös komentotulkin silmukoilla.

Miten integroin i18n-convert:in CI/CD-putkeeni?

Asenna se npm:llä CI-ympäristöösi ja lisää sitten vaihe, joka suorittaa i18n-convert:in lähdekäännöstiedostojen muututtua. Ohita CI:n interaktiiviset kehotteet --force-valitsimella. Yhdistä se i18n-validate:en varmistaaksesi, että muunnetut tiedostot ovat täydellisiä ja oikein muodostettuja.

i18n-muunnin

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

Muunna yli 32 i18n-tiedostomuodon välillä: Android XML, iOS Strings, XLIFF, PO, JSON, YAML ja muut. Häviötön mahdollisuuksien mukaan ja selkeät varoitukset tietojen menetyksestä muulloin.

Ongelma

Jokainen alusta käyttää eri käännösmuotoa. Android käyttää strings.xml-tiedostoa. iOS käyttää .strings- ja .stringsdict-tiedostoja. Verkkosovellukset käyttävät JSON:ia tai YAML:ia. Kääntäjät ja TMS-alustat haluavat XLIFF- tai PO-muodon. Kun merkkijonoja on jaettava alustojen välillä, päädyt kopioimaan ja liittämään muotojen välillä, kirjoittamaan kertakäyttöisiä komentosarjoja tai järjestämään tiedostoja käsin uudelleen. Se on työlästä, virhealtista ja rikkoutuu aina uuden muodon ilmestyessä.

Yksi mobiili- ja verkkoprojekti voi helposti sisältää yli viisi eri käännöstiedostomuotoa. Niiden pitäminen käsin synkronoituina on mahdoton tehtävä.

Ratkaisu

i18n-convert on yksi CLI-työkalu, joka muuntaa yli 32 i18n-tiedostomuodon välillä. Se tunnistaa syötemuodon automaattisesti, säilyttää mahdollisimman suuren osan rakenteesta ja varoittaa, jos muunnos menettäisi tietoja, kuten monikkomuodot CSV-muodossa.

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

Automaattinen tunnistus

Syötemuoto tunnistetaan automaattisesti tiedostopäätteestä ja sisällöstä. Valitsimia ei tarvita.

Häviötön mahdollisuuksien mukaan

Metatiedot, kommentit ja monikkomuodot säilytetään, kun kohdemuoto tukee niitä.

Varoitukset tietojen menetyksestä

Kun muunnos menettäisi tietoja, saat nimenomaiset varoitukset ennen yhdenkään tiedoston kirjoittamista.

Asennus

Asenna helpoimmin npm:llä, macOS:ssä Homebrew:lla tai koosta lähdekoodista Cargolla.

Terminal

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

npm-paketti sisältää valmiit binääritiedostot macOS:lle, Linux:ille ja Windows:ille. Rust-työkaluketjua ei tarvita.

Tavalliset muunnokset

Useimmat tiimit tarvitsevat toistuvasti muutamia muunnoksia: JSON Android XML -muotoon mobiilia varten, PO JSON-muotoon verkkoa varten ja XLIFF-edestakaismuunnokset kääntäjille luovutusta varten. Tässä on tavallisia malleja.

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/

Tuetut muodot

i18n-convert tukee yli 32 muotoa mobiili-, verkko-, lokalisointistandardi- ja tiedonsiirtoluokissa.

Mobiili

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

Verkko

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

Lokalisointistandardit

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

Tiedonsiirto

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

Varoitukset tietojen menetyksestä

Kaikki muodot eivät ole samanarvoisia. XLIFF tukee huomautuksia, asiayhteyksiä ja monikkomuotoja. CSV ei tue niistä mitään. Kun muunnat monipuolisesta muodosta yksinkertaisempaan, i18n-convert kertoo täsmälleen, mitä menetetään.

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

Käytä tuotannossa aina --dry-run-valitsinta ennen muuntamista yksinkertaisempaan muotoon. Näet kaikki varoitukset kirjoittamatta tiedostoja.

CI-integraatio

Automatisoi muotojen synkronointi CI/CD-putkessasi. Kun lähdekäännöstiedosto muuttuu, luo kaikki johdetut muodot automaattisesti uudelleen, jotta mobiili-, verkko- ja kääntäjätiedostot pysyvät synkronoituina.

.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

Yhdistä i18n-convert ja i18n-validate CI-putkessasi. Muunna muodot ensin ja validoi sitten, että kaikki kohdetiedostot ovat täydellisiä ja oikein muodostettuja.