Osnovni pojmovi

Sve u Ownlate-u visi o pet objekata. Kada shvatite kako se ugnežđuju, ostatak proizvoda — API, CLI, uređivač — čita se na isti način.

radni prostor
├── članovi, glosar, memorija prevoda, QA pravila, API ključevi, naplata
└── projekat
    ├── fajl prevoda
    │   └── segment ── prevod (po jedan za svaki ciljni jezik)
    ├── izdanje ── OTA distribucija
    ├── zadatak, integracija, SDK token

Radni prostor

Radni prostor je zakupac. Pravi se sa imenom i valutom naplate, poseduje plan i pretplatu, i ništa u njemu nije vidljivo iz drugog prostora.

Na nivou prostora žive i dele ih svi projekti u njemu:

Članovi i njihovi nivoi pristupa
Glosar — terminologija, po izvornom jeziku
Memorija prevoda — svi odobreni prevodi, upotrebljivi svuda
QA pravila — sopstveni regularni izrazi koji se proveravaju pri slanju
API ključevi — programski pristup u granicama vaših dozvola
Dnevnik revizije — zapis značajnih radnji koji se samo dopunjava
Integracije — one sa opsegom prostora, koje važe za sve projekte

Prostor ima UUID. Skoro svaka REST putanja počinje njime, i skoro svaka GraphQL operacija ga prima kao workspaceId.

Projekat

Projekat je jedan proizvod ili njegov deo i drži njegove tekstove.

Polje	Značenje
`sourceLanguage`	Jezik na kom programeri pišu. Jedan po projektu, ne menja se nakon kreiranja.
`targetLanguages`	Na šta se prevodi. Nove dodajete bilo kada.
`visibility`	`private` ili `public` — napredak i prevodi javnog projekta čitaju se bez prijave.
`status`	`active` ili `archived`. Arhiviranje sakriva projekat bez uništavanja; brisanje arhiviranog je trajno.
`ossApprovedAt`	Postavlja se kada platforma odobri javni projekat kao otvoren — vidite ispod.

Otvoreni projekti

Javni projekat platforma može dodatno odobriti kao otvoren. Otvoreni projekat ulazi u javni katalog, i predlog prevoda u njemu može ostaviti bilo ko prijavljen, ne samo član. Predlog ništa ne menja dok ga recenzent ne prihvati. Vidite Proces prevođenja.

Fajl prevoda

Fajl je jedinica koju otpremate i izvozite. Ima ime, putanju foldera i format, a ime i putanja zajedno ga identifikuju: locales/en.json je jedan fajl, mobile/en.json drugi.

Format se prepoznaje po ekstenziji pri otpremanju i određuje kako se sadržaj razlaže na segmente. Preimenovanje foldera jednom radnjom prepisuje putanju svim fajlovima ispod njega.

Segment

Segment je jedan prevodivi tekst u jednom fajlu — nivo na kom radi sve ostalo.

Polje	Značenje
`key`	Identifikator koji kod koristi, npr. `home.title`. Ugnežđeni JSON i YAML ključevi se ravnaju tačkom.
`sourceText`	Tekst na izvornom jeziku projekta.
`isPlural`	Da li segment nosi oblike množine umesto jednog teksta.
`translatable`	Postavlja se na false za ključ koji se nikada ne prevodi — ime brenda, format token. Takve segmente predprevod preskače, a u izvoz idu sa izvornim tekstom.
`contextUrl`, `screenshotUrl`	Gde se tekst pojavljuje, za prevodioce koji ga inače ne vide.

Promena izvornog teksta označava sve njegove prevode kao outdated — ono što je prevodilac odobrio više ne opisuje ono što proizvod govori.

Prevod

Svaki segment nosi po jedan prevod za svaki ciljni jezik, a svaki prevod ima tekst (ili mapu oblika množine) i status.

Status	Značenje
`untranslated`	Još ništa nije napisano
`draft`	Sačuvano kao rad u toku, nije poslato
`needs_review`	Poslato, čeka recenzenta
`reviewed`	Recenzent je pregledao, čeka odobrenje
`approved`	Potvrđeno — to je ono što se izvozi i objavljuje
`in_progress`	Odbijeno je i prerađuje se
`outdated`	Izvorni tekst se promenio nakon što je prevod napisan

Oblici množine čuvaju se kao mapa CLDR kategorija koje ciljni jezik zaista koristi — zero, one, two, few, many, other.

Memorija prevoda

Svaki put kada se prevod odobri, par (izvorni tekst → ciljni tekst) upisuje se u memoriju prevoda prostora. Podudaranje se ocenjuje Levenštajnovom sličnošću od 0 do 100, gde je 100 tačno podudaranje; na tome počivaju predlozi u uređivaču i predprevod. Vidite Memorija prevoda.

Izdanje i distribucija

Izdanje je zamrznuti snimak odobrenih prevoda projekta, numerisan rastućom verzijom. Projekat takođe ima jednu OTA distribuciju — trajni pristupni ključ koji preko HTTP-a, bez autentifikacije, servira poslednje izdanje ili bilo koju raniju verziju. Vidite Izdanja i OTA.

Šta se računa kao reč

Planovi se mere rečima, a reč je token teksta prevoda odvojen belinom. Brojač se pomera kada se prevod upiše, a ukupan zbir prostora može se u svakom trenutku ponovo izračunati iz odobrenih prevoda. Vidite Planovi i naplata.