Útmutatók

Közösségi fordítás

A Komodod magyar és angol szövegeit a KOFA weboldalán (kofa.kncsk.hu/forditas) a közösség más nyelvekre fordíthatja. A fordítások két úton jutnak el a felhasználókhoz: a futó KOFA szerverek letöltik őket, és te be is égetheted őket a Komod következő verziójába.

Honnan jönnek a szövegek?

Amikor egy kiadott (nem preview) verziót töltesz fel a Komod tárba, és az a Komod legújabb kiadott verziója, a weboldal átveszi a csomag i18n/ és i18n/client/ mappájának hu.json és en.json szótárát. Erről a Többnyelvű Komod oldal szól.

Csak a hu.json kulcsai kerülnek át; az angol szöveg segít a fordítónak, a szerkesztőmező abból indul.
Új kulcs minden nyelvben lefordítatlanként jelenik meg. A kimaradt kulcs elavult lesz, a fordítása megmarad a régebbi verziókhoz.
Ha az angol szöveg megváltozik, a meglévő fordítás „elavult” jelölést kap, amíg valaki át nem nézi.
A metaadatok (név, leírás, portok) is fordíthatók, ha a kulcsuk benne van a hu.json-ban.
Hibás szótár nem akasztja meg a feltöltést, csak a szövegek nem lesznek fordíthatók.

Megjegyzés

A preview verziók nem számítanak: a fordítók mindig a legutóbbi kiadás szövegeit látják.

Ki fordíthat?

Új nyelvet és fordítást a weboldal aktivált fiókkal rendelkező felhasználói adhatnak hozzá. A magyar és az angol szöveg a te csomagodé: azt a weboldalon nem lehet átírni, csak egy új verzióval.

A Komod oldalán a tárban látszik, milyen közösségi nyelvekre és hány százalékban van lefordítva. Egy nyelvre kattintva a szerkesztő csak a Komod lefordítatlan kulcsait mutatja.

Karbantartói jogok

A Komod gazdája és társfeltöltői (és az adminok):

Kikapcsolhatják a közösségi fordítást a Komod oldalán. Ilyenkor csak ők fordíthatják a Komodot, és a nyelvi csomagok kihagyják a közösségi szövegeit.
Visszaállíthatják a Komod kulcsainak bármelyik változását a fordítás naplójában.

Hogyan jut el a felhasználóhoz?

Egy nyelv akkor számít kiadottnak, ha a program saját szövegeinek elég nagy része le van fordítva (alapból 60%). A kiadott nyelveket a futó KOFA szerverek naponta letöltik, újratelepítés nélkül; a felhasználó a nyelvválasztóban látja őket.

A Komod szövegeinél a saját fordításod nyer: a közösségi szöveg csak azokat a kulcsokat tölti ki, amelyek a csomagodban nincsenek lefordítva arra a nyelvre.

Beégetés a következő verzióba

kofa-pack i18n pull acme.demo.thermostat MyKomod MyKomod.Ui

Az első paraméter a csomag azonosítója, utána a projekt mappák (alapból az aktuális mappa). Minden projektben kell i18n/hu.json.
Egy kulcs abba a projektbe kerül, amelyiknek a hu.json-jában szerepel. Az i18n/<nyelv>.json többi kulcsa megmarad, a weboldal szövege felülírja a fájlbelit.
Csak a nem elavult fordítások jönnek le. A régebbi verzió kulcsait kihagyja, és kiírja, hány ilyen volt.
A nyelvek leírását az i18n/languages.json-ba írja.
--server <cím>: más weboldal (alapból https://kofa.kncsk.hu).

Utána buildeld és töltsd fel a következő verziót: ettől kezdve ezek a Komod saját fordításai.

Nyelvleírás (`languages.json`)

Egy nem beépített nyelvnek leírás kell: neve, tartalék nyelve és a többes szám szabálya. A kofa-pack i18n pull megírja, de kézzel is felveheted:

[
  { "code": "pl", "name": "Polish", "nativeName": "Polski", "fallback": "en", "plural": "polish" }
]

A plural értéke dönti el, milyen többes szám alakokat vár a szótár:

`plural`	Nyelvek	Alakok
`one-other`	magyar, angol, német, spanyol, olasz …	`one`, `other`
`none`	japán, kínai, koreai, vietnámi	`other`
`french`	francia, portugál (a 0 is egyes szám)	`one`, `other`
`east-slavic`	orosz, ukrán, belarusz	`one`, `few`, `many`, `other`
`polish`	lengyel	`one`, `few`, `many`, `other`
`czech`	cseh, szlovák	`one`, `few`, `many`, `other`
`arabic`	arab	`zero`, `one`, `two`, `few`, `many`, `other`

Egyetlen nyelvet i18n/language.json is leírhat (egy objektum, ugyanezekkel a mezőkkel). Ismeretlen plural értékű csomagot a kofa-pack elutasít.