Hvaða þýðingarskráasnið styður i18n-convert?

i18n-convert styður yfir 32 snið, þar á meðal Android XML (strings.xml), iOS Strings (.strings), iOS Stringsdict (.stringsdict), Flutter ARB, JSON (flatt og faldað), YAML, Rails YAML, XLIFF 1.2 og 2.0, Gettext PO/POT, TMX, TBX, Java Properties, CSV, TSV og Excel (.xlsx).

Tapa ég gögnum þegar ég umbreyti milli sniða?

Það fer eftir sniðaparinu. Umbreyting milli jafn tjáningarríkra sniða, til dæmis úr JSON í YAML eða XLIFF 1.2 í 2.0, er taplaus. Umbreyting úr innihaldsríku sniði í einfaldara snið, til dæmis úr PO með fleirtölum í CSV, veldur upplýsingatapi. i18n-convert varar þig við hverju því gagnastaki sem myndi tapast og gerir þér kleift að hætta við með --dry-run.

Get ég umbreytt mörgum skrám í einu?

Já. Tilgreindu möppu í stað stakrar skrár og i18n-convert vinnur úr öllum þekktum þýðingarskrám í möppunni. Notaðu --out-dir til að tilgreina úttaksmöppuna. Þú getur einnig notað skeljarlykkjur til að stjórna heitum einstakra skráa nánar.

Hvernig tengi ég i18n-convert við CI/CD-vinnslukeðjuna mína?

Settu upp með npm í CI-umhverfinu þínu og bættu síðan við skrefi sem keyrir i18n-convert eftir að frumþýðingarskrárnar breytast. Notaðu --force til að sleppa gagnvirkum fyrirspurnum í CI. Notaðu það ásamt i18n-validate til að tryggja að umbreyttu skrárnar séu fullgerðar og rétt formaðar.

i18n-sniðbreytir

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

Umbreyttu milli yfir 32 i18n-skráasniða. Android XML, iOS Strings, XLIFF, PO, JSON, YAML og fleira. Taplaust þegar unnt er, annars með skýrum viðvörunum um gagnatap.

Vandamálið

Hvert kerfi notar sitt eigið þýðingarsnið. Android notar strings.xml. iOS notar .strings og .stringsdict. Vefforrit nota JSON eða YAML. Þýðendur og TMS-kerfi vilja XLIFF eða PO. Þegar deila þarf strengjum milli kerfa endarðu á að afrita og líma milli sniða, skrifa sértækar skriftur eða endurskipuleggja skrár handvirkt. Þetta er þreytandi, hætt við villum og bregst í hvert sinn sem nýtt snið kemur fram.

Eitt verkefni fyrir farsíma og vef getur auðveldlega falið í sér yfir 5 mismunandi þýðingarskráasnið. Það er vonlaus barátta að halda þeim samstilltum handvirkt.

Lausnin

i18n-convert er eitt skipanalínuverkfæri sem umbreytir milli yfir 32 i18n-skráasniða. Það greinir inntakssniðið sjálfkrafa, varðveitir eins mikla formgerð og unnt er og varar þig við þegar umbreyting myndi valda gagnatapi, til dæmis á fleirtölum í 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

Sjálfvirk greining

Inntakssniðið er greint sjálfkrafa út frá skráarendingu og innihaldi. Engar færibreytur eru nauðsynlegar.

Taplaust þegar unnt er

Lýsigögn, athugasemdir og fleirtöluform varðveitast þegar marksniðið styður þau.

Viðvaranir um gagnatap

Þegar umbreyting myndi valda upplýsingatapi færðu skýrar viðvaranir áður en nokkur skrá er skrifuð.

Uppsetning

Settu upp með npm á einfaldasta hátt, Homebrew á macOS eða smíðaðu úr frumkóða með Cargo.

Terminal

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

npm-pakkinn inniheldur forsmíðaðar keyrsluskrár fyrir macOS, Linux og Windows. Rust-verkfærakeðja er ekki nauðsynleg.

Algengar umbreytingar

Flest teymi þurfa að endurtaka nokkrar umbreytingar: úr JSON í Android XML fyrir farsíma, úr PO í JSON fyrir vefinn og XLIFF fram og til baka við afhendingu til þýðenda. Hér eru nokkur algeng mynstur.

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/

Studd snið

i18n-convert styður yfir 32 snið fyrir farsíma, vef, staðfærslustaðla og gagnaskipti.

Farsímar

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

Vefur

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

Staðfærslustaðlar

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

Gagnaskipti

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

Viðvaranir um gagnatap

Snið bjóða upp á mismunandi möguleika. XLIFF styður athugasemdir, samhengi og fleirtöluform. CSV styður ekkert af þessu. Þegar þú umbreytir úr innihaldsríku sniði í einfaldara snið segir i18n-convert þér nákvæmlega hvað tapast.

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

Notaðu ávallt --dry-run áður en þú umbreytir í einfaldara snið í rekstrarumhverfi. Þá sérðu allar viðvaranir án þess að nokkrar skrár séu skrifaðar.

Samtenging við CI

Gerðu samstillingu sniða sjálfvirka í CI/CD-vinnslukeðjunni þinni. Þegar frumþýðingarskráin breytist eru öll afleidd snið endurgerð sjálfkrafa svo skrár fyrir farsíma, vef og þýðendur haldist samstilltar.

.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

Notaðu i18n-convert ásamt i18n-validate í CI-vinnslukeðjunni þinni. Umbreyttu sniðunum fyrst og staðfestu síðan að allar markskrár séu fullgerðar og rétt formaðar.