Fajlovi, formati i izvoz

Tekstovi projekta stižu kao fajlovi i odlaze kao fajlovi. Ova stranica govori o oba smera.

Podržani formati

Format	Ekstenzije	Napomene
JSON	`.json`	Ugnežđeni objekti se ravnaju tačkom
Flutter ARB	`.arb`	Razlaže se kao JSON
YAML	`.yaml`, `.yml`	Ugnežđeni ključevi se ravnaju tačkom
gettext	`.po`	Parovi `msgid` / `msgstr`
Android resursi	`.xml`	`<string name="…">`
Apple strings	`.strings`, `.stringsdict`	`"key" = "value";`
XLIFF	`.xliff`, `.xlf`	trans-unit verzija 1.2 i 2.0
CSV	`.csv`	Prva kolona ključ, druga vrednost
Markdown	`.md`, `.mdx`	Po segment za svaki blok, uređuje se kao Markdown

Format se uzima iz ekstenzije, a fajl sa ekstenzijom koja nije na ovom spisku odbija se uz poruku koja nabraja dozvoljene.

Ugnežđene strukture postaju ključevi sa tačkom, pa ovaj fajl:

{ "home": { "title": "Zdravo", "cta": "Počni" } }

daje ključeve home.title i home.cta. Njih će vaš kod tražiti i njih izvoz upisuje nazad.

Otpremanje

Otpremanje izvornog fajla pravi po segment za svaki ključ u njemu. Ponovno otpremanje istog fajla — isto ime, isti folder — način je da pošaljete izmene:

Postojećem ključu se ažurira izvorni tekst.
Ranije obrisan ključ se vraća.
Novi ključ se dodaje.
Redosled u fajlu postaje redosled segmenata, pa blok umetnut u sredinu ostaje u sredini umesto da skoči na kraj.

Uvoz postojećih prevoda

Otpremite fajl sa zadatim ciljnim jezikom i on se čita kao prevodi, a ne kao izvor: vrednosti se po ključu vezuju za postojeće segmente i upisuju u taj jezik. Prevod koji već ima status zadržava ga, pa uvoz ne skida odobrenje potiho.

To je put za preseljenje iz drugog alata: prvo pošaljite izvorni fajl, pa po fajl za svaki jezik.

Folderi

Fajlovi žive u folderima unutar projekta, a fajl se identifikuje imenom i putanjom: locales/en.json i mobile/en.json su dva različita fajla.

Preimenovanje foldera jednom radnjom premešta sve fajlove ispod njega.
Spajanje duplikata čisti fajlove istog imena i putanje napravljene dvaput — čest ishod toga što su isti fajl poslala dva pipeline-a pre nego što je ijedan imao identifikator fajla.

Izvoz

Izvoz upisuje odobrene prevode nazad u fajl.

Šta	Gde
Jedan jezik, jedan format	Kartica „Fajlovi“ → Izvoz, ili `GET /v1/workspaces/{id}/segments/export`
Svi jezici kao ZIP	Kartica „Fajlovi“ → Izvezi sve, ili `GET /v1/workspaces/{id}/segments/export-zip`
Pravo u repozitorijum	`ownlate pull`
Kao paket za izvršavanje	Izdanja i OTA

Izvoz daje json, yaml ili po. Bez izričitog formata koristi se format samog fajla.

Dve opcije menjaju ono što završi u fajlu:

Zamena izvorom — prosledite izvorni jezik i neprevedeni ključevi se upisuju sa izvornim tekstom umesto da budu izostavljeni. Koristite kada bi nedostajući ključ srušio aplikaciju; isključite kada radije želite da vidite rupu.
Neprevodivi segmenti uvek se upisuju sa izvornim tekstom, šta god drugo tražili.