časť 36
Tritisíc osemsto kľúčov a osemdesiatjeden súborov: texty ako stromy
Za dva dni sa 3 839 kľúčov prekladov rozdelilo do 9 balíkov, prepísalo na stromy v abecede a dostalo cestu balíka. Čo z toho je hotové a čo nie je.
Do 30. októbra 2026 ležali preklady hry Audamir v deviatich veľkých súboroch, po jednom na jazyk, a nová hra v cárstve si mohla vyžiadať úpravu jadra aj vtedy, keď jadro nepotrebovala. Od 31. októbra do 1. novembra, teda za dva dni, sa to zmenilo v piatich krokoch. Zistilo sa, že dnes je 3 839 kľúčov v 81 súboroch v priečinkoch deviatich balíkov, každý kľúč začína cestou svojho balíka, každý súbor je strom a mená v každej skupine idú abecedne. Podľa dôkazov v dokumentoch hry sa nezmenil ani jeden text, no jadro stále pozná Kastgard (94 hrán v 21 súboroch) a nové cárstvo si ešte pýta riadok v tabuľke jadra.
Odkiaľ sa vyšlo: deväť súborov a jedno jadro
Dňa 30. októbra 2026 sa zisťovalo, prečo nová hra v cárstve núti upraviť jadro, aj keď hra „needs no change in core“ (docs/I18N-SPLIT.md; dokumenty hry sú po anglicky). Analýza z toho večera zmerala:
- Súbory: deväť katalógov, 3 727 kľúčov, spolu 3 024 062 bajtov, jeden riadok jeden kľúč.
- Cena jednej hry: commit, ktorý pridal Čiary, pridal do každého z deviatich katalógov jadra 42 riadkov (378 riadkov, 40 kľúčov). Z nich bolo 31 vlastných a 9 čítalo jadro.
- Kto kľúč píše: jadro 1 965 kľúčov (52,7 %), Stacks 1 094 (29,4 %), Campaign 595 (16,0 %), Taflgard (dnes Rokgard) a jeho dve hry 73 (2,0 %).
Odporúčanie analýzy bolo iné, než čo sa postavilo: nechať kľúče bez zmeny a riadky plochými. Rozhodnutie z 31. októbra bolo opačné; DESIGN §98 cituje autora: „aby vlastník zostal do budúcna jednoznačný“. Kľúč teda nesie cestu balíka: core.settings.size.values.small.label, kastgard.stacks.presets.classic.label, rokgard.colony.rule_move. Vlastníka určuje jedno pravidlo: kľúč patrí do najnižšieho balíka, ktorý smú čítať všetky súbory, čo ho píšu, inak do jadra. Hra nesmie čítať texty inej hry (okrem hry, na ktorej stavia) ani svojho cárstva a jadro nečíta text žiadneho balíka; pýta si ho z manifestu, ktorý kľúč pomenúva ako dáta.
Päť krokov za dva dni
Verzie sú z commitov Version ….
| Krok | Čo | Čísla |
|---|---|---|
| S1, §98 | správca I18n.add, strážca, pilot na Taflgarde | 124 kľúčov v 27 súboroch |
| S2, §112, verzia 0.70.6 | strom, premenovanie, rozdelenie Kastgardu a jadra | 3 665 kľúčov, 4 652 literálov v 145 súboroch, 32 985 riadkov |
| šablóna 1, §113, verzia 0.70.9 | Rokgard, Vitgard, Telgard, Kolónia, Čiary | 52 premenovaní |
| abeceda, §114, verzia 0.70.10 | poradie mien v každej skupine | 81 súborov |
| šablóna 2, §115, verzia 0.70.18 | Kastgard | 36 premenovaní |
Medzi S1 a S2 sa stihlo premenovanie Taflgardu na Rokgard. Vďaka ceste v kľúči stačili dva príkazy: node tools/i18n-rename.js --prefix taflgard rokgard rk vyrobil 125 riadkov mapy a --map … --step rk --write premenoval 169 literálov v 15 súboroch a 1 116 riadkov v 36 súboroch katalógov (DESIGN §102). Mapa docs/I18N-RENAMES.tsv má dnes 4 041 riadkov: S1 124, rk 125, S2 3 665 a dva kroky domovskej obrazovky, H5b 20 a H6 107 (kľúče, ktoré sa presunuli s kódom do balíka Kastgardu).
Takto vyzerá dnes anglický súbor cárstva Rokgard (texty skrátené):
rokgard: {
realm: {
coin: 'Golden tokens',
genre: 'Board games',
hero_note: 'Your hero is the token, …',
name: 'Rokgard',
},
restart_what_chains: 'The game starts from the beginning …',
restart_what_colony: 'The game starts from the beginning …',
},
Celý kľúč sa v strome nedá nájsť grepom, preto je tu node tools/i18n.js --where KĽÚČ: vypíše súbor, ktorý kľúč píše, vlastníka podľa pravidla a riadok v každom z deviatich jazykov.
Kto má koľko kľúčov
Počty sú z manažéra textov (I18n.owners) po načítaní katalógu angličtiny, 1. 11. 2026:
| Balík | Kľúčov | Podiel | Súbory kódu | Súbory textov |
|---|---|---|---|---|
core | 1 700 | 44,3 % | (jadro má 102 súborov) | 9 |
kastgard | 140 | 3,6 % | 5 | 9 |
kastgard/stacks | 934 | 24,3 % | 67 | 9 |
kastgard/campaign | 923 | 24,0 % | 32 | 9 |
rokgard | 6 | 0,2 % | 4 | 9 |
rokgard/colony | 38 | 1,0 % | 9 | 9 |
rokgard/chains | 90 | 2,3 % | 10 | 9 |
vitgard | 4 | 0,1 % | 3 | 9 |
telgard | 4 | 0,1 % | 3 | 9 |
| spolu | 3 839 | 133 | 81 |
Každý jazyk má 3 839 z 3 839 textov. Číslo nie je porovnateľné s 3 727 z analýzy: kľúčov pribúda (3 790 po S1, 3 806 po S2). Kastgard má 1 997 kľúčov, 52 %, jadro 44,3 % namiesto 52,7 %. Cieľ analýzy, 906 kľúčov jadra (24,3 %), sa zatiaľ nenaplnil: krok M8b (rozdelenie zmiešaných súborov platformy) nie je dokončený a z jadra vedie do Kastgardu ešte 84 hrán.
Dva kľúče, ktoré sa ukladajú
Starým kódom sa zahrala misia so zradcom a scenár so zradou do 5. kola a uložili sa; v celom úložisku sa našli presne dva kľúče katalógu, events.betray_notice a mission.traitor.events.text. Oba majú alias v tabuľke RENAMED v js/i18n/i18n.js: t(kľúč) pri neúspechu hľadá pod novým menom. Tabuľka sa nevyrába z celej mapy, lebo by to bol kód pre každú stránku kvôli dvom kľúčom; strážca G10 overí, že starý kľúč už nie je kľúčom, nový je a mapa ten riadok má.
Abecedne, vždy: pravidlo, ktoré má strážcu a test
Po S2 prišla pripomienka k súborom: kľúče sú rozhádzané a majú byť vždy abecedne (DESIGN §114). Nebolo to náhodou: strom z S2 radil skupiny podľa prvého výskytu. Teraz sú mená každej skupiny v abecednom poradí na každej úrovni vo všetkých 81 súboroch. Poradie nezávisí od stroja ani od jazyka (compareNames v tools/i18n-format.js):
| Pravidlo | Príklad |
|---|---|
| písmená podľa kódu, veľkosť sa ignoruje | liveMusic pred livePicture |
| súvislý rad číslic je číslo | 2 pred 10, rank.2 pred rank.10 |
| meno, ktoré je začiatkom iného, je prvé | live pred liveMusic |
- pred číslicami, číslice pred _ a písmenami | A, a-b, a1, a_b, b |
| celý kľúč po menách od koreňa | a, a.b, a.c, a-b.c |
Žiadne miestne nastavenie: test odmieta localeCompare aj Intl v zdroji funkcie. Text a skupina stoja v jednom rade a komentár // ---- názov ---- ide so skupinou, pred ktorou stojí.
Kde pravidlo žije
Je to pravidlo s tromi vrstvami, nie dohoda:
- Zapisovač. Nikto poradie nepíše ručne: nový kľúč sa napíše kamkoľvek do jeho skupiny a
node tools/i18n.js --fragments --fixprepíše každý súbor, ktorý nie je tak, ako ho zapisovač píše. - Strážca G9 (
node tools/i18n.js --fragments --check). V kópii stromu v pracovnom priečinku sa vymenili dva riadky vjs/realms/rokgard/i18n/sk.jsa strážca vypísal: *G9 1 file(s) of rokgard do not have the names of a group in alphabetical order (…/sk.js); the first: …/sk.js:18 inrokgard,restart_what_chainsstands afterrestart_what_colony: run node tools/i18n.js --fragments --fix*. Na pôvodnom strome hlási „3839 keys in 9 packages … everything is fine“. - Testy.
tests/tools/i18n-format.test.jsmá test „the real catalogues: each of the 81 files …“: pre každý súbor žiada prázdny zoznamdisorder, poradie kľúčov rovnéFormat.sortKeysa poradieObject.keyspo spustení súboru rovné poradiu súboru. Test „the order of the names (DESIGN §114)“ overuje úplné usporiadanie na 160 menách (25 600 dvojíc a 6 000 trojíc podľa §114.1).tests/tools/i18n-fragments.test.jsmá test „G9, the order“ s mutáciami: vymenené kľúče, skupina na zlom mieste,10pred2, komentár odtrhnutý od skupiny. Oba súbory sa 1. 11. 2026 pustili samostatne: 11 z 11 a 16 zo 16 prešlo.
Poradie potrebovali len výpisy (--export, rodová kontrola, prehľad pre prekladateľov). Prehľad mal skupinu „Nastavenia“ obmedzenú na prvých 22 z 36 popisiek, čo by po abecede vynechalo size, sound a speed; limit je teraz 40. Pravidlo platí pre súbory v zozname i18nNested, dnes všetkých deväť; plochý súbor, ktorý nástroje čítajú pre rozpracované zmeny, si drží poradie riadkov, no žiadny katalóg plochý nie je.
Prečo: nové cárstvo a západky
Rozhodnutie z 31. októbra: nové cárstva Vitgard a Telgard sa budú pridávať postupne a môžu vznikať paralelne (DESIGN §104). Kostra každého je 3 súbory kódu, 9 súborov textov a 4 kľúče (meno, minca, žáner a text karty). Nová hra pridá vlastný priečinok s vrstvami, textami a zrkadlom testov. Strážia to tri nezávislé západky:
| Západka | Čo drží | Stav 1. 11. 2026 |
|---|---|---|
| kľúče (G1, G5, G7) | súbor píše len kľúče, ktoré jeho balík smie čítať; kľúč začína cestou balíka; počet kľúčov jadra, čo pomenúvajú balík, môže len klesať | 36 kľúčov, tabuľka povoľuje 36 (i18nRatchet) |
| hrany kódu | tools/packages.js --check: počet hrán na súbor, ktoré porušujú smer, sa smie len zmenšiť; sedem balíkov z deviatich je clean, tam zlyhá hocijaké nové porušenie | 94 hrán v 21 súboroch z 1 186 |
Hrany sa menili takto: 120 v 22 súboroch pri presune Kastgardu (31. 10., Presun, ktorý nesmie nič zmeniť), 107 pri S2, 105 po H5b a 94 po H6, keď sa záložky štatistík presunuli z jadra do balíka Kastgardu (profileview.js 11 → 0). Kľúče: i18nRatchet bol 22 po S1, 41 po S2 (širšia definícia: pribudli slová kastgard, stacks, campaign) a 36 po H6. Z 94 hrán má js/ui/app.js sám 39; z jadra vedie 58 do Stacks, 24 do Campaign, 2 do Kastgardu, 2 do Kolónie a po jednej do Rokgardu, Čiar, Vitgardu a Telgardu, plus 4 hrany zo Stacks do Campaign.
Čo nové cárstvo stále mení v jadre
Pravda je nepohodlnejšia než slogan „bez zásahu do jadra“. Nové cárstvo prináša svoje súbory a texty do svojho priečinka, no registrácia ostáva na spoločných miestach. V js/core/modetable.js majú Vitgard aj Telgard svoj riadok (REALMS, riadky 45 a 46) a dokument ho nazýva mostom do kroku M9. Tabuľka registračných bodov v DESIGN §104.5 má 20 riadkov a 13 z nich je označených „shared“ (index.html, sw.js, tools/compat.html, tabuľka balíkov, js/ui/app.js, style.css, …). Tabuľka je z 31. 10. a neprerátala sa. Texty sú na tom lepšie, ale nie celkom: kľúče hry ležia v jej priečinku, no to, čo musí ukázať jadro (dlaždica, popis v histórii), ostáva kľúčmi jadra a nová hra ich do kroku S4 pridá (DESIGN §98.3); strážca ich len spočíta.
Kampaň má 923 kľúčov (95 KB surových, 25 KB po gzip v angličtine). Ušetrili by sa len v builde bez kampane, taký build ešte nie je: do kampane vedie 34 hrán z balíkov, ktoré nie sú voliteľné (packages.js).
Stránka v angličtine dnes načíta 9 súborov textov, v inom jazyku 18 (I18n.packFiles; pred S1 jeden, resp. dva). Zostavený build ich zlepí do jedného súboru na jazyk, takže zostavená stránka načíta dva ako predtým (DESIGN §98.1, §112.5).
Čo je hotové, čo ostáva a čo sa nepodarilo overiť
| Vec | Stav |
|---|---|
| texty v balíkoch, kľúče s cestou (S1, S2) | hotové, 31. 10. 2026 |
| strom a abecedné poradie, strážca G9 a testy | hotové |
alias pre uložené kľúče (RENAMED, G10) | hotové, 2 kľúče |
| S4: 36 kľúčov jadra o balíkoch ako dáta manifestov | len navrhnuté (DESIGN §112.11) |
| čisté jadro (M8b), tabuľka cárstiev mimo jadra (M9) | nie, 94 hrán |
| build bez kampane | nie je taký build |
| zmazanie 451 komentárov dávok | nerobí sa, čaká na pokyn |
Z nálezov o dokumentoch: docs/I18N.md na konci píše o „22 kľúčoch, ktoré pomenúvajú hru“, kým tabuľka hovorí 36. Dva testy v tests/tools/i18n-fragments.test.js majú v názve ešte „21 keys of core“ a „27 files of Rokgard and 27 of Kastgard“. Nadpis DESIGN §112 „every other key“ nemá znamenať „každý druhý kľúč“, ale všetky ostatné kľúče: cestu balíka nesie všetkých 3 839 (korene: core 1 700, kastgard 1 997, rokgard 134, vitgard 4, telgard 4).
Zdroje a poznámky
- Zadanie a analýza:
docs/I18N-SPLIT.md,docs/ROADMAP.mdkap. 29. - Kroky a čísla:
docs/DESIGN.md§98, §102, §104 a §112 až §115. - Merania z 1. 11. 2026 (hra 0.81.2):
node tools/i18n.js --check(3 839 z 3 839),node tools/i18n.js --fragments --check,node tools/packages.js --check(1 186 hrán, 94 porušuje),node --testnad testami formátu. - Citáty sú z dokumentov hry po anglicky, s dátumom.
Čo sa nepodarilo overiť: dôkazy z DESIGN (rovnaký odtlačok všetkých deviatich jazykov, 36 a 68 obrazoviek v štyroch jazykoch, údaje zo starého kódu, celé sady testov) sa pri písaní nespustili znova; prečítali sa, spustili sa len ľahké kontroly vyššie. Nehral sa offline režim so službou sw.js. Čas načítania s 9 súbormi namiesto jedného sa na sieti nemeral; prototyp z analýzy dal 24 – 202 ms proti 66 – 104 ms v skrytom paneli, čo dokument sám nazýva šumom. Nemeralo sa, či abeceda a stromy šetria čas autorom a prekladateľom; DESIGN to uvádza ako dôvod, nie ako výsledok.