Apakah format fail terjemahan yang disokong oleh i18n-convert?

i18n-convert menyokong lebih daripada 32 format, termasuk Android XML (strings.xml), iOS Strings (.strings), iOS Stringsdict (.stringsdict), Flutter ARB, JSON (rata dan tersarang), YAML, Rails YAML, XLIFF 1.2 dan 2.0, Gettext PO/POT, TMX, TBX, Java Properties, CSV, TSV, dan Excel (.xlsx).

Adakah data akan hilang apabila menukar antara format?

Ia bergantung pada pasangan format. Penukaran antara format dengan daya ekspresi setara (JSON kepada YAML, XLIFF 1.2 kepada 2.0) tidak kehilangan data. Penukaran daripada format kaya kepada format lebih ringkas (PO dengan bentuk jamak kepada CSV) akan menghilangkan maklumat. i18n-convert memberi amaran tentang setiap data yang akan hilang dan membolehkan anda membatalkan dengan --dry-run.

Bolehkah saya menukar beberapa fail sekali gus?

Boleh. Berikan direktori dan bukannya satu fail, lalu i18n-convert akan memproses semua fail terjemahan yang dikenali dalam direktori tersebut. Gunakan --out-dir untuk menentukan direktori output. Anda juga boleh menggunakan gelung shell untuk lebih banyak kawalan terhadap penamaan setiap fail.

Bagaimanakah saya menyepadukan i18n-convert ke dalam saluran CI/CD?

Pasang melalui npm dalam persekitaran CI, kemudian tambahkan langkah yang menjalankan i18n-convert selepas fail terjemahan sumber berubah. Gunakan --force untuk melangkau gesaan interaktif dalam CI. Pasangkan dengan i18n-validate untuk memastikan fail hasil penukaran lengkap dan berformat baik.

Penukar i18n

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

Tukar antara lebih daripada 32 format fail i18n. Android XML, iOS Strings, XLIFF, PO, JSON, YAML, dan banyak lagi. Tanpa kehilangan data apabila boleh, dengan amaran jelas jika tidak.

Masalahnya

Setiap platform menggunakan format terjemahan yang berbeza. Android menggunakan strings.xml. iOS menggunakan .strings dan .stringsdict. Aplikasi web menggunakan JSON atau YAML. Penterjemah dan platform TMS mahukan XLIFF atau PO. Apabila perlu berkongsi rentetan antara platform, anda perlu menyalin-tampal antara format, menulis skrip sekali guna, atau menyusun semula fail secara manual. Proses ini meletihkan, mudah tersilap, dan rosak setiap kali format baharu muncul.

Satu projek mudah alih + web boleh melibatkan lebih daripada 5 format fail terjemahan yang berbeza dengan mudah. Mengekalkannya segerak secara manual ialah perjuangan yang tidak berkesudahan.

Penyelesaiannya

i18n-convert ialah satu alat CLI yang menukar antara lebih daripada 32 format fail i18n. Alat mengesan format input secara automatik, mengekalkan sebanyak mungkin struktur, dan memberi amaran apabila penukaran akan kehilangan data (seperti bentuk jamak dalam 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

Pengesanan Automatik

Format input dikesan secara automatik daripada sambungan fail dan kandungan. Tiada bendera diperlukan.

Tanpa Kehilangan Data Apabila Boleh

Metadata, komen, dan bentuk jamak dikekalkan jika format sasaran menyokongnya.

Amaran Kehilangan Data

Apabila penukaran akan menghilangkan maklumat, anda menerima amaran yang jelas sebelum fail ditulis.

Pemasangan

Pasang melalui npm untuk persediaan paling mudah, Homebrew pada macOS, atau bina daripada sumber dengan Cargo.

Terminal

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

Pakej npm menyertakan binari siap bina untuk macOS, Linux, dan Windows. Tiada rantai alat Rust diperlukan.

Penukaran Umum

Kebanyakan pasukan berulang kali memerlukan beberapa penukaran: JSON kepada Android XML untuk mudah alih, PO kepada JSON untuk web, dan perjalanan pergi balik XLIFF untuk penyerahan kepada penterjemah. Berikut ialah beberapa corak umum.

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/

Format yang Disokong

i18n-convert menyokong lebih daripada 32 format untuk kategori mudah alih, web, standard penyetempatan, dan pertukaran data.

Mudah Alih

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

Standard Penyetempatan

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

Pertukaran Data

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

Amaran Kehilangan Data

Tidak semua format setara. XLIFF menyokong nota, konteks, dan bentuk jamak. CSV tidak menyokong semua itu. Apabila anda menukar format kaya kepada format lebih ringkas, i18n-convert memberitahu dengan tepat data yang akan hilang.

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

Sentiasa gunakan --dry-run sebelum menukar kepada format lebih ringkas dalam pengeluaran. Pilihan ini memaparkan semua amaran tanpa menulis fail.

Penyepaduan CI

Automatikkan penyegerakan format dalam saluran CI/CD. Apabila fail terjemahan sumber berubah, jana semula semua format terbitan secara automatik supaya fail mudah alih, web, dan penterjemah kekal segerak.

.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

Gabungkan i18n-convert dengan i18n-validate dalam saluran CI. Tukar format terlebih dahulu, kemudian sahkan bahawa semua fail sasaran lengkap dan berformat baik.