časť 56
Ako sa hra Audamir prekladá dnes: konštrukcie v texte, načítanie a veľkosť súborov v čase
Preklady hry dnes: čo smie byť v jednom texte (parameter, množné číslo, rod, vnorenie), ako sa texty načítajú do pamäte a ako sa za 19 dní menili súbory, s číslami z gitu.
Článok Päť jazykov, jeden rod a klávesa H hovorí o tom, prečo „5 kociek“ nie je „2 kocky“ a ako sa hra vyhýba rodu hráča. Tento je o tom, z čoho sa preklad hry skladá: čo všetko smie byť v jednom texte, ako sa texty dostanú do pamäte stránky a ako sa za 19 dní zmenilo ich uloženie, od dvoch súborov po 81. Päť krokov z 31. októbra a 1. novembra rozoberá Texty ako stromy; tu je každý z nich len veta a číslo.
Stav je hra Audamir 0.124.0 zo 6. novembra 2026. Čísla sú z gitu a z nástrojov hry, s príkazom v zdrojoch na konci; čo je odhad alebo vysvetlenie, je tak označené. Tento článok je čítanie kódu a meranie z gitu; hra sa nemenila.
Štyri slová, ktoré sa opakujú. Kľúč je meno textu (core.settings.dice_count). Katalóg je tabuľka kľúč → text pre jeden jazyk. Balík je časť hry s vlastnými textami: jadro, cárstvo alebo hra (dnes deväť, napríklad core, kastgard/stacks, rokgard/colony) a vlastníkom kľúča je balík, ktorý ho definuje. Správca (v kóde I18n, inak aj manažér) zlučuje súbory balíkov do katalógov a hľadá v nich.
Od dvoch súborov k stromom: veľkosti v čase
Git hry začína 18. októbra 2026 a už vtedy má texty po jazykoch: en.js a sk.js, spolu 313 kB. Skorší jeden veľký súbor so všetkým v gite nie je; ak existoval, bol pred prvým commitom. Čo v gite je, je osem zmien a ich cena v bajtoch (súbory js/i18n/<jazyk>.js a js/realms/**/i18n/<jazyk>.js, bez kódu správcu):
| Bod | Čo sa zmenilo | Súbory | Kľúče | Spolu | Najväčší |
|---|---|---|---|---|---|
| 18. 10. | prvý commit: en, sk | 2 | 1 883 | 313 kB | 157 kB |
| 19. 10. | + cs, sr, ru | 5 | 2 588 | 1 162 kB | 310 kB |
| 19. 10. | balíky jazykov | 5 | 2 588 | 1 162 kB | 310 kB |
| 22. 10. | + es, pt-br, fr, de | 9 | 3 434 | 2 765 kB | 412 kB |
| 30. 10., hra 0.63.7 | pred rozdelením | 9 | 3 727 | 3 024 kB | 452 kB |
| 31. 10., hra 0.65.6 | prvé balíky | 36 | 3 790 | 3 100 kB | 445 kB |
| 31. 10., hra 0.70.3 | stromy a Kastgard | 81 | 3 806 | 3 190 kB | 195 kB |
| 1. 11., hra 0.84.0 | po stromoch | 81 | 3 865 | 3 238 kB | 180 kB |
| 6. 11., hra 0.124.0 | dnes | 81 | 4 196 | 3 481 kB | 201 kB |
git ls-tree -l a git cat-file. Súčet bajtov súborov s textami bez kódu správcu; pod stĺpcom je počet súborov, najväčší súbor a počet kľúčov angličtiny. 1 kB = 1 000 bajtov.Prvý riadok obrázka má angličtinu a slovenčinu takmer rovnako veľké. Čím viac jazykov, tým viac šedého: ostatných sedem jazykov (cs, sr, ru, es, pt-br, fr, de) tvorí dnes 2 771 kB z 3 481 kB, teda 80 %.
Čo z čísel plynie, a čo nie:
- Súčet rástol jedenásťkrát (313 → 3 481 kB), ale nie preto, že by texty zbytnali. Kľúčov je 2,2-krát viac (1 883 → 4 196) a jazykov 4,5-krát viac (2 → 9). Na jeden anglický kľúč pripadá v každom bode 80 až 84 bajtov súboru (82,6 na začiatku, 80,9 pred rozdelením, 83,8 po stromoch, 82,9 dnes). Veľkosť sa riadi počtom kľúčov krát počet jazykov. Po gzip (každý súbor osobitne) je to 90 kB na začiatku a 987 kB dnes.
- Rozdelenie do balíkov nezmenšilo celok, zmenšilo najväčší súbor. Od 19. októbra je najväčší vždy ruský súbor, lebo cyrilika má na písmeno dva bajty: 452 kB 30. októbra, po rozdelení 195 kB, dnes 201 kB. Najväčší anglický súbor je dnes jadro, 139 kB. Súborov je 81 namiesto deviatich a hlavičky (komentár a obal súboru) zaberajú 60 kB, teda 1,7 % celku; pred rozdelením to boli 4 kB.
- Strom nie je menší. Analýza z 30. októbra (
docs/I18N-SPLIT.md, 3.3) zmerala, že zanorený strom ušetrí 4,3 % bajtov angličtiny a 3,1 % po gzip; v otázke z toho dňa sa čakalo na súbor, ktorý je „smaller and clearer“. Potom ale pribudla cesta balíka v každom kľúči a jeden list na riadok. Výsledok v gite: 80,9 → 83,8 bajtu na anglický kľúč, teda o 3,6 % viac. Polovicu tvoria hlavičky 81 súborov; bez nich je to 80,8 → 82,3 bajtu (o 1,8 % viac) a dnes 81,4. Príčina zvyšku sa nemerala (kandidáti sú predpona balíka v každej ceste, odsadenie hlbokých úrovní a komentáre skupín). Jasnejšie to je a o to išlo; menšie nie. - Súčet v repozitári nie je to, čo stránka načíta. Pred commitom z 19. októbra stránka načítala všetkých päť katalógov (7 súborov, 1 178 kB), od neho angličtinu a jeden jazyk: v angličtine 4 súbory a 226 kB, v slovenčine 5 súborov a 441 kB. Dnes rozhoduje, či ide o zdrojové súbory alebo o zostavenú hru; o tom je oddiel o načítaní.
Prvé balíky vznikli 31. októbra pre cárstvo, ktoré sa vtedy volalo Taflgard a dnes sa volá Rokgard; stromy a Kastgard toho istého dňa. Sú to kroky S1 a S2 z Textov ako stromov.
Všetko, čo smie byť v jednom texte
Text v katalógu je obyčajný reťazec. Zložené zátvorky v ňom smú byť štyri druhy: parameter, skupina množného čísla, rodová skupina a skupina v skupine. Pravidlá sú v úvodnom komentári js/i18n/i18n.js. Z 4 196 textov má parameter 915, skupinu množného čísla 236 (angličtina a španielčina) až 272 (francúzština) a rodovú skupinu 85 v slovenčine, 81 v češtine, 78 v srbčine a 60 v ruštine. Angličtina rodovú skupinu nemá žiadnu. Príklady sú z katalógov hry.
Parameter {meno}
Slovo v zátvorkách, ktoré hra vymení za hodnotu: {played} {played#hra|hry|hier} · {pct} výhier (kľúč core.hub.stats.text). Parameter, ktorý chýba, ostane v texte ({x}), undefined sa vypíše ako undefined a null ako null, tak ako to robí šablónový reťazec JavaScriptu.
Každý jazyk má tie isté parametre ako angličtina.
Skupina množného čísla {n#a|b|c}
Za # sú tvary od prvého po posledný a ten, ktorý sa vyberie, závisí od čísla a od pravidla jazyka. Pravidlo má v packs.js meno (plural) a sú štyri:
| Pravidlo | Jazyky | Tvary | ||
|---|---|---|---|---|
two | en, es, de | 1 \ | ostatné | |
zero-one | fr, pt-br | pod 2 \ | ostatné | |
west-slavic | sk, cs | 1 \ | 2 až 4 \ | ostatné |
east-slavic | sr, ru | 1, 21 … \ | 2 až 4, 22 … \ | ostatné |
Podrobnosti o ruskom pravidle sú v 016, tu je iný text a čo z neho hra vyrobí (core.settings.dice_count, výstup z volania t nad skutočnými katalógmi):
en {k} {k#die|dice}
0 dice · 1 die · 2 dice
de {k} {k#Würfel|Würfel}
1 Würfel · 2 Würfel
fr {k} {k#dé|dés}
0 dé · 1 dé · 1.5 dé · 2 dés
sk {k} {k#kocka|kocky|kociek}
1 kocka · 2 kocky · 5 kociek
21 kociek
ru {k} {k#кубик|кубика|кубиков}
1 кубик · 2 кубика · 5 кубиков
11 кубиков · 21 кубик
Tri veci stoja za povšimnutie. Nemčina má dva rovnaké tvary: skupina má mať vždy aspoň dva. Ak má skupina menej tvarov, než pravidlo žiada, berie sa posledný. A skupina len vyberie tvar: zlomok vypíše tak, ako ho dostane (1.5 s bodkou), desatinnú čiarku robí až I18n.decimal.
Čeština, srbčina a ruština majú presne tri tvary.
Rodová skupina {gender#…}
Tri tvary: pre muža, pre ženu a pre nikoho konkrétneho. Rod nie je parameter, ale nastavenie Rod[1] (m, f, n, predvolené n), ktoré sa číta pri načítaní stránky tak ako jazyk, preto sa stránka po zmene nastavenia načíta znova. Tretí tvar je text taký, aký bol pred rodom, takže kto nič nezvolil, zmenu nevidí. Tvar smie byť celá veta (core.app.eliminated_text; zalomené, v súbore je skupina na jednom riadku):
sk {gender#
Bol si vyradený v {round}. kole.
Skús to znova.|
Bola si vyradená v {round}. kole.
Skús to znova.|
Vyradenie v {round}. kole.
Skús to znova.}
muž: Bol si vyradený v 7. kole.
žena: Bola si vyradená v 7. kole.
inak: Vyradenie v 7. kole.
ru Тебя выбили в раунде {round}.
Попробуй снова.
en You were eliminated in round
{round}. Try again.
Rodovú skupinu si vyberá jazyk, nie kľúč: ten istý kľúč má v slovenčine, češtine a srbčine tri tvary a v ruštine vetu, ktorá rod obchádza. Angličtina rod nemá nikde a balík to hovorí (genders: false v packs.js), čím sa skryje aj riadok nastavenia.
Skupina v skupine
Rodová skupina sa nehľadá vzorom, ale počítaním zátvoriek: scanGender sleduje hĺbku { a } a tvary delí čiarou | len na prvej úrovni. Vnútri tvaru preto môže byť čokoľvek, aj skupina množného čísla. Najprv sa vyberie rod, potom sa vyplnia ostatné skupiny. V katalógoch ich je po dva až tri v slovenčine, češtine, srbčine a ruštine a inde žiadny (core.die.result_boxes v češtine a ruštine):
cs {gender#
Otevřel jsi {n}
{n#krabici|krabice|krabic}: {faces}.|
Otevřela jsi {n}
{n#krabici|…}: {faces}.|
Otevřeno: {n} {n#krabice|…} – {faces}.}
žena, 3: Otevřela jsi 3 krabice: …
muž, 5: Otevřel jsi 5 krabic: …
ru muž, 21: Ты открыл 21 коробку: …
žena, 2: Ты открыла 2 коробки: …
inak, 12: Открыто: 12 коробок – …
Chýbajúci kľúč a uložený kľúč
Kľúč, ktorý v jazyku chýba, hra vezme z angličtiny; ak nie je ani tam, vráti samotný kľúč a zapíše ho do I18n.missing. Keď sa core.hub.stats.text vymaže zo slovenčiny, ukáže sa 5 games · 40 % wins, keď sa vymaže aj z angličtiny, ukáže sa core.hub.stats.text. V hre to nemá nastať, lebo každý kľúč z kódu je v katalógoch. Drobnosť z tohto pokusu: záložný anglický text sa vypĺňa pravidlom aktuálneho jazyka, takže ruský katalóg bez dice_count dal pre 21 „21 die“ namiesto „21 dice“.
Kľúč sa niekedy ukladá: záznam hry má udalosti ako { k: 'v', key }, aby sa uložená hra ukázala v jazyku, ktorý je zvolený neskôr. Taký kľúč sa v kóde obalí trk('…') (I18n.key, ktoré kľúč len vráti a označí, že sa preloží až pri zobrazení). Ak sa uložený kľúč premenuje, stará hra ho stále pozná: tabuľka RENAMED v správcovi má dva riadky, napríklad events.betray_notice → kastgard.stacks.events.betray_notice, a t('events.betray_notice') ukáže text nového kľúča.
Čísla, percentá a veľké písmená
I18n.decimal(1.5) dá 1,5 v slovenčine, češtine, srbčine, ruštine, španielčine, francúzštine a nemčine a 1.5 v angličtine. I18n.percent(56) dá 56 % s medzerou v slovenčine, češtine a ruštine, s nezalomiteľnou medzerou v španielčine, francúzštine a nemčine a 56% bez nej v angličtine, srbčine a brazílskej portugalčine. Je to šablóna percent v packs.js ('{n} %', '{n}%'). Nemčina má príznak capitalNouns: I18n.lower nechá názov nastavenia s veľkým písmenom, lebo nemecké podstatné mená ho majú vždy.
Odvodený a referenčný jazyk
Srbská cyrilika nemá vlastný katalóg. Záznam sr-cyrl v packs.js má derive: 'sr' a scripts: ['js/i18n/translit-sr.js']: katalóg sa vyrobí z latinky prepisom pri prvom použití ({played} {played#igra|igre|igara} · {pct} pobeda dá 5 игара · 40% победа) a vyrobí sa znova, keď pribudnú texty (počítadlo generation v správcovi). Prvé použitie trvalo v meraní 72 a 77 ms a drží pamäť navyše. Angličtina je reference: true: načíta sa vždy a je záložným jazykom každého iného.
Vlastnosti jazyka v packs.js
Jazyk je jeden riadok zoznamu js/i18n/packs.js. Srbčina v latinke a cyrilike (skrátené a zalomené):
{ id: 'sr', name: 'Srpski',
locale: 'sr-Latn-RS', htmlLang: 'sr-Latn',
decimal: ',', percent: '{n}%',
plural: 'east-slavic', file: 'js/i18n/sr.js',
beta: true, tags: ['sr-latn', 'sr-me'] },
{ id: 'sr-cyrl', name: 'Српски',
locale: 'sr-Cyrl-RS', htmlLang: 'sr-Cyrl', …,
beta: true, derive: 'sr',
scripts: ['js/i18n/translit-sr.js'],
tags: ['sr-cyrl', 'sr-rs', 'sr'] },
tags hovoria, aký jazyk prehliadača tento záznam vyberie (sr-RS dá cyrilike, sr-Latn latinke), htmlLang je lang stránky, ak sa líši od id, beta označí koncept, file je katalóg jadra. Nový jazyk tak nepotrebuje nič ďalšie okrem súboru na balík a riadku v zozname; index.html a workery číta zo zoznamu.
Správca: ako sa texty načítajú a ukladajú do pamäte
js/i18n/i18n.js a js/i18n/boot.js (hra 0.124.0). Schéma prečítaná z kódu, nie meranie; čísla v treťom kroku sú z merania súborov.1. Tri skripty. index.html načíta packs.js (zoznam jazykov), i18n.js (správca) a boot.js (zavádzač) v tomto poradí; to isté robí každý Web Worker. Worker nemá vlastný jazyk: detect() v ňom dá angličtinu a boot.js ju načíta cez importScripts; svoje miesto v js/ zistí z adresy (js/worker/x.js je dve úrovne pod koreňom, js/realms/rokgard/games/colony/worker/x.js šesť).
2. Jazyk. Poradie v detect(): premenná DW_LANG (len testy a nástroje v node), adresa ?lang=xx (odkaz z webu hry; vyhrá nad uloženým jazykom), uložené nastavenie, jazyk prehliadača podľa tags, angličtina. Uložený jazyk je v nastavení audamir.settings ako cfg.lang; správca si ho číta sám, lebo sa načíta skôr než úložisko hry. Čisté node ignoruje jazyk počítača, preto testy zostávajú anglické.
3. Zavádzač. I18n.packFiles() vráti zoznam súborov: angličtina (jadro a osem balíkov) a potom zvolený jazyk. boot.js pre každý napíše document.write('<script src=…>'). Zapísané skripty bežia hneď po boot.js, v poradí a pred ďalším skriptom stránky: je to jediný spôsob, ako mať texty skôr než moduly, ktoré ich používajú, bez asynchrónneho štartu celej hry, a funguje aj zo súboru. Stránka, ktorá je už prečítaná, sa nechá tak. Súbor, ktorý sa nepodarí načítať, nie je smrteľný: texty z neho padnú na angličtinu po jednom.
4. Registrácia. Každý súbor sa končí I18n.add(jazyk, balík, texty). Správca strom sploští na kľúč → text, kľúč, ktorý už je, odmietne (prvý zostane, odmietnutie ide do I18n.conflicts), zapíše vlastníka do I18n.owners a balík do I18n.sources.
5. Hľadanie. t(kľúč, parametre) hľadá v katalógu jazyka, potom v angličtine, potom v RENAMED, a inak vráti kľúč. Text bez { a bez parametrov sa vráti hneď; inak sa skladá zakaždým znova. Okrem odvodenej cyriliky sa nič nekešuje: žiadna pamäť hotových viet, len vyhľadanie v objekte a výmena zátvoriek.
6. Zmena jazyka. reloadForLanguage uloží rozohranú hru, nastavenie a zavolá location.reload(). Za chodu sa nič nevymieňa: texty vznikajú pri načítaní modulov, preto sa stránka načíta znova.
js/i18n/i18n.js) a odhad haldy V8 (node --expose-gc, heapUsed po dvoch zberoch, jeden scenár na proces; hra 0.124.0). Odhad textov, nie meranie prehliadača.Čo je potom v pamäti
Jeden register na stránku: objekt I18N_CATALOGS s plochým katalógom na jazyk, dnes angličtina a zvolený jazyk po 4 196 kľúčoch, k tomu OWNERS (kľúč → balík, tiež 4 196), SOURCES (jazyk → deväť balíkov) a CONFLICTS. Odhad haldy, keď sa súbory jazyka spustia v prázdnom kontexte V8: 2,1 MB v angličtine, 3,6 MB s dvoma jazykmi, 4,6 MB so srbskou cyrilikou (odvodený katalóg je druhý objekt navyše) a 15,0 MB, keď sa načíta všetkých deväť jazykov naraz, ako to robia testy a nástroje. Pre zostavenú hru je to 1,9 MB a 3,1 MB. Číslo zahŕňa všetko, čo skripty po sebe nechajú na halde; je to odhad textov, nie meranie prehliadača.
Service worker a cache
sw.js hry má v zozname pri inštalácii len angličtinu (v zdrojoch jadro a osem balíkov …/en.js, v zostavenej hre i18n/en.js); ostatné jazyky sa uložia, keď sa prvýkrát použijú, lebo obsluha fetch ukladá každé získané GET z vlastného pôvodu, a to „najprv sieť, potom cache“. Overené v headless Chromium nad zostavenou hrou (príkaz audamir-055-sw-cdp.js v zdrojoch):
| Krok | Čo sa stalo |
|---|---|
| A: prvá návšteva | angličtina; worker aktívny; cache hry (názov nesie verziu 0.124.0 a odtlačok zostavenia) má i18n.js a i18n/en.js |
B: ?lang=sk | načíta sa i18n/sk.js (275 kB), cache má nový súbor, uložený jazyk je sk |
| C: ďalšia návšteva bez parametra | slovenčina z uloženého nastavenia |
| D: server vypnutý (bez siete) | stránka v slovenčine z cache, 4 196 kľúčov |
E: bez siete a uložená ru | i18n/ru.js nie je v cache; worker na jeho žiadosť odpovedá súborom index.html (87 170 bajtov), katalóg ru má 0 kľúčov a všetky texty sú anglické |
Vyplýva z toho, čo 016 už hovorí: prvé prepnutie na nový jazyk potrebuje sieť. Teraz je aj overené, čo sa stane bez nej: hra nespadne, ale hovorí po anglicky.
Zdrojové súbory proti zostavenej hre
Vývojový režim (hra beží zo zdrojov bez zostavenia) načíta každý balík ako vlastný súbor: stránka v angličtine 12 súborov (deväť s textami a tri správcu), v slovenčine 21. Zostavená hra (tools/build.js) súbory jazyka zlepí do jedného, i18n/<id>.js, a zmenší: stránka načíta i18n.js (zoznam jazykov, správca a zavádzač, 9,7 kB), i18n/en.js a i18n/<jazyk>.js. Prepínač --languages en,sk zostaví len tie balíky, ktoré sa žiadajú.
js/ proti zostavenej hre (node tools/build.js zo stromu hry 0.124.0: súbory i18n.js, i18n/en.js a i18n/<jazyk>.js). Veľkosť po gzip -9 každého súboru osobitne, 1 kB = 1 000 bajtov.Zostavená hra má v angličtine 2 súbory a 88 kB po gzip, v slovenčine 3 súbory a 183 kB, najviac 199 kB (ruština). Zdrojové súbory majú 12 a 21 súborov a 111 a 222 kB. Zostavenie teda nielen lepí: ušetrí 16 až 21 % z prenosu po gzip a 83 až 86 % súborov.
Čo si z toho odnášam
- Veľkosť sa riadi počtom kľúčov krát počet jazykov, nie formou súboru. Strom nebol menší (o 3,6 % väčší na kľúč); prínos je v prehľadnosti a v tom, že najväčší súbor je dnes 201 kB namiesto 452 kB.
- Konštrukcia v texte je zmluva medzi kľúčom a jazykom. Parameter, množné číslo, rod a vnorenie sa čítajú podľa pravidla jazyka, nie podľa kľúča.
- Texty sa načítajú synchrónne a raz. Žiadna výmena za chodu: zmena jazyka je opätovné načítanie. Jednoduchosť stojí 12 až 21 súborov vo vývoji a jeden súbor na jazyk v zostavení.
- Čo sa nedá načítať, padne na angličtinu. Rezerva je v správcovi kľúč po kľúči, preto jazyk bez jedného súboru nespadne; offline je to overené.
- Meranie z gitu ukázalo, čo odhad nevidel. Analýza čakala menší strom; commit ukázal väčší. Preto sa číslo berie z commitu.
Zdroje a poznámky
- Stav a metóda: hra Audamir 0.124.0 (6. 11. 2026); počas písania pribudol jeden commit s nástrojmi, texty rovnaké. Hra sa len čítala: veľkosti sú z
git ls-tree -lagit cat-filenad stavmi hry z tabuľky; zostavenie, pamäť a headless Chromium bežali na kópii stromu (git archive). - Veľkosti v čase (tabuľka a obrázok): body z
git logod 18. 10. do 6. 11.; kľúče spočítané spustením súborov v izolovanom kontexte (audamir-055-sizes.js);gzip -9príkazového riadku. Hlavičky súborov sú bajty predreturn {a za koncom objektu. Čísla pre 30. 10. sa zhodujú sdocs/I18N-SPLIT.mda s 036. - Konštrukcie a načítanie:
js/i18n/i18n.js(úvodný komentár),js/i18n/packs.js,js/i18n/boot.js,js/ui/app.js,js/ui/store.js,sw.js; ukážky z katalógov a výstupy volanítnad katalógmi stavu 0.124.0 (audamir-055-demos.js). - Pamäť a zostavenie: odhad haldy
audamir-055-memory.js(V8 vnode24); headless Chromium cez CDP nad zostavenou hrou (audamir-055-sw-cdp.js);node tools/build.jszo stavu 0.124.0. - Nemeralo sa: pamäť v prehliadači, čas načítania cez sieť, gzip pri spojení balíkov do jedného súboru po minifikácii.
Poznámky
- Do verzie 0.108.0 sa nastavenie volalo Pohlavie (Neurčité, Muž, Žena); od verzie 0.108.1 zo 4. novembra 2026 sa volá Rod (Neurčený, Mužský, Ženský; anglicky Grammatical gender). ↩︎