Alapfogalmak

Az Ownlate-ben minden öt objektumon nyugszik. Ha egyszer érti, hogyan ágyazódnak egymásba, a termék többi része — az API, a CLI, a szerkesztő — ugyanígy olvasható.

munkaterület
├── tagok, szójegyzék, fordítási memória, QA-szabályok, API-kulcsok, számlázás
└── projekt
    ├── fordítási fájl
    │   └── szegmens ── fordítás (célnyelvenként egy)
    ├── kiadás ── OTA-terjesztés
    ├── feladat, integráció, SDK-token

Munkaterület

A munkaterület a bérlő. Névvel és számlázási pénznemmel jön létre, csomagja és előfizetése van, és semmi sem látszik belőle egy másik munkaterületről.

Munkaterület szintjén él, és minden benne lévő projekt osztozik rajta:

• Tagok és hozzáférési szintjeik
• Szójegyzék — terminológia forrásnyelvenként
• Fordítási memória — minden jóváhagyott fordítás, bárhol újrahasznosítható
• QA-szabályok — saját reguláris kifejezések, beküldéskor ellenőrizve
• API-kulcsok — programozott hozzáférés a saját jogosultságai keretében
• Naplózás — a fontos műveletek csak bővíthető nyilvántartása
• Integrációk — a munkaterület hatókörűek, amelyek minden projektre érvényesek

A munkaterületet UUID azonosítja. Szinte minden REST-útvonal ezzel kezdődik, és szinte minden GraphQL-művelet workspaceId néven kéri.

Projekt

A projekt egy termék vagy annak egy része, és annak szövegeit tartja.

Mező	Jelentés
sourceLanguage	Az a nyelv, amelyen a fejlesztők írnak. Projektenként egy, létrehozás után nem módosul.
targetLanguages	Amire fordítjuk. Továbbiak bármikor felvehetők.
visibility	private vagy public — a nyilvános projekt haladása és fordításai bejelentkezés nélkül olvashatók.
status	active vagy archived. Az archiválás elrejti a projektet anélkül, hogy megsemmisítené; az archivált törlése végleges.
ossApprovedAt	Akkor kap értéket, ha a platform a nyilvános projektet nyitottá minősíti — lásd lent.

Nyitott projektek

Egy nyilvános projektet a platform ezen felül nyitottnak minősíthet. A nyitott projekt bekerül a nyilvános katalógusba, és fordítási javaslatot bárki hagyhat rajta, aki be van jelentkezve — nem csak a tagok. A javaslat semmit sem változtat, amíg egy lektor el nem fogadja. Lásd: Fordítási folyamat.

Fordítási fájl

A fájl az, amit feltölt és exportál. Neve, mappaútvonala és formátuma van, és a kettő együtt azonosítja: a locales/en.json az egyik fájl, a mobile/en.json egy másik.

A formátumot feltöltéskor a kiterjesztésből ismeri fel a rendszer, és ez dönti el, hogyan bomlik a tartalom szegmensekre. Egy mappa átnevezése egyetlen művelettel átírja az alatta lévő összes fájl útvonalát.

Szegmens

A szegmens egy fordítandó szöveg egy fájlban — az a szint, amelyen minden más dolgozik.

Mező	Jelentés
key	A kód által használt azonosító, például home.title. A beágyazott JSON- és YAML-kulcsok ponttal lapulnak ki.
sourceText	A szöveg a projekt forrásnyelvén.
isPlural	Hordoz-e a szegmens többes számú alakokat egyetlen szöveg helyett.
translatable	Hamisra állítja azt a kulcsot, amelyet soha nem szabad lefordítani — márkanév, formátumtoken. Az ilyen szegmenseket az előfordítás kihagyja, és a forrásszövegükkel kerülnek exportba.
contextUrl, screenshotUrl	Hol jelenik meg a szöveg — azoknak a fordítóknak, akik másképp nem látják.

Egy szegmens forrásszövegének módosítása minden fordítását outdated állapotúra jelöli: amit a fordító jóváhagyott, már nem azt írja le, amit a termék mond.

Fordítás

Minden szegmens célnyelvenként egy fordítást hordoz, és minden fordításnak van szövege (vagy többes számú alakok térképe) és állapota.

Állapot	Jelentés
untranslated	Még semmi sincs megírva
draft	Munkapéldányként mentve, nincs beküldve
needs_review	Beküldve, lektorra vár
reviewed	A lektor átnézte, jóváhagyásra vár
approved	Elfogadva — ez kerül exportba és kiadásba
in_progress	Elutasították, átdolgozás alatt
outdated	A forrásszöveg megváltozott a fordítás megírása után

A többes számú alakok azoknak a CLDR-kategóriáknak a térképeként tárolódnak, amelyeket a célnyelv ténylegesen használ — zero, one, two, few, many, other.

Fordítási memória

Valahányszor jóváhagynak egy fordítást, a (forrásszöveg → célszöveg) pár bekerül a munkaterület fordítási memóriájába. A találatot 0-tól 100-ig terjedő Levenshtein-hasonlóság pontozza, ahol a 100 a pontos egyezés; ezen alapulnak a szerkesztő javaslatai és az előfordítás. Lásd: Fordítási memória.

Kiadás és terjesztés

A kiadás a projekt jóváhagyott fordításainak befagyasztott pillanatképe, növekvő verziószámmal. A projektnek egy OTA-terjesztése is van: egy állandó hozzáférési kulcs, amely HTTP-n, hitelesítés nélkül szolgálja ki a legutóbbi kiadást vagy bármely korábbi verziót. Lásd: Kiadások és OTA.

Mi számít szónak

A csomagokat szavakban mérjük, és a szó a fordítás szövegének szóközzel elválasztott egysége. A számláló akkor mozdul, amikor egy fordítás beíródik, a munkaterület összesítése pedig bármikor újraszámolható a jóváhagyott fordításokból. Lásd: Csomagok és számlázás.