Fájlok, formátumok és export

Egy projekt szövegei fájlként érkeznek és fájlként távoznak. Ez az oldal mindkét irányról szól.

Támogatott formátumok

Formátum	Kiterjesztések	Megjegyzés
JSON	`.json`	A beágyazott objektumok ponttal lapulnak ki
Flutter ARB	`.arb`	JSON-ként értelmezve
YAML	`.yaml`, `.yml`	A beágyazott kulcsok ponttal lapulnak ki
gettext	`.po`	`msgid` / `msgstr` párok
Android erőforrások	`.xml`	`<string name="…">`
Apple strings	`.strings`, `.stringsdict`	`"key" = "value";`
XLIFF	`.xliff`, `.xlf`	1.2-es és 2.0-s trans-unit
CSV	`.csv`	Első oszlop a kulcs, második az érték
Markdown	`.md`, `.mdx`	Blokkonként egy szegmens, Markdownként szerkesztve

A formátum a kiterjesztésből adódik, és az a fájl, amelynek kiterjesztése nincs a listán, olyan üzenettel kerül elutasításra, amely felsorolja az elfogadottakat.

A beágyazott szerkezetekből pontozott kulcsok lesznek, így ez a fájl:

{ "home": { "title": "Szia", "cta": "Kezdés" } }

a home.title és a home.cta kulcsot adja. Ezeket fogja a kódja keresni, és ezeket írja vissza az export.

Feltöltés

A forrásfájl feltöltése minden kulcsához létrehoz egy szegmenst. Ugyanannak a fájlnak az ismételt feltöltése — azonos név, azonos mappa — a módja annak, hogy módosításokat küldjön:

A meglévő kulcs forrásszövege frissül.
A korábban törölt kulcs visszatér.
Az új kulcs bekerül.
A fájl sorrendje lesz a szegmensek sorrendje, így a középre beszúrt blokk középen marad, nem ugrik a végére.

Meglévő fordítások importálása

Ha a feltöltéskor célnyelvet ad meg, a fájl fordításként, nem forrásként olvasódik be: az értékek kulcs alapján párosulnak a meglévő szegmensekhez, és abba a nyelvbe íródnak. Az a fordítás, amelynek már van állapota, megtartja azt, így az import nem vonja vissza csendben a jóváhagyást.

Ez az útvonal egy másik eszközből való átköltözéshez: előbb küldje fel a forrásfájlt, aztán nyelvenként egy fájlt.

Mappák

A fájlok mappákban élnek a projekten belül, és a fájlt a név és az útvonal azonosítja: a locales/en.json és a mobile/en.json két különböző fájl.

Egy mappa átnevezése egyetlen művelettel áthelyezi az alatta lévő összes fájlt.
Duplikátumok összevonása kitakarítja az azonos nevű és útvonalú, kétszer létrehozott fájlokat — ez gyakori eredménye annak, hogy ugyanazt a fájlt két pipeline töltötte fel, mielőtt bármelyiknek lett volna fájlazonosítója.

Exportálás

Az export a jóváhagyott fordításokat írja vissza fájlba.

Mit	Hol
Egy nyelv, egy formátum	Fájlok lap → Exportálás, vagy `GET /v1/workspaces/{id}/segments/export`
Minden nyelv ZIP-ben	Fájlok lap → Összes exportálása, vagy `GET /v1/workspaces/{id}/segments/export-zip`
Egyenesen a repóba	`ownlate pull`
Futásidejű csomagként	Kiadások és OTA

Az export json, yaml vagy po formátumot ad. Kifejezett formátum nélkül magának a fájlnak a formátuma érvényes.

Két beállítás módosítja, mi kerül a fájlba:

Visszaesés a forrásra — adjon meg forrásnyelvet, és a lefordítatlan kulcsok a forrásszövegükkel íródnak ki ahelyett, hogy kimaradnának. Akkor használja, ha a hiányzó kulcs elrontaná az alkalmazást; hagyja ki, ha inkább látná a hiányt.
A nem fordítandó szegmensek mindig a forrásszövegükkel íródnak ki, bármit is kért egyébként.