Audamir

č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.

· 12 min čítania

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, §98správca I18n.add, strážca, pilot na Taflgarde124 kľúčov v 27 súboroch
S2, §112, verzia 0.70.6strom, premenovanie, rozdelenie Kastgardu a jadra3 665 kľúčov, 4 652 literálov v 145 súboroch, 32 985 riadkov
šablóna 1, §113, verzia 0.70.9Rokgard, Vitgard, Telgard, Kolónia, Čiary52 premenovaní
abeceda, §114, verzia 0.70.10poradie mien v každej skupine81 súborov
šablóna 2, §115, verzia 0.70.18Kastgard36 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íkKľúčovPodielSúbory kóduSúbory textov
core1 70044,3 %(jadro má 102 súborov)9
kastgard1403,6 %59
kastgard/stacks93424,3 %679
kastgard/campaign92324,0 %329
rokgard60,2 %49
rokgard/colony381,0 %99
rokgard/chains902,3 %109
vitgard40,1 %39
telgard40,1 %39
spolu3 83913381

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):

PravidloPríklad
písmená podľa kódu, veľkosť sa ignorujeliveMusic pred livePicture
súvislý rad číslic je číslo2 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ísmenamiA, a-b, a1, a_b, b
celý kľúč po menách od koreňaa, 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:

  1. Zapisovač. Nikto poradie nepíše ručne: nový kľúč sa napíše kamkoľvek do jeho skupiny a node tools/i18n.js --fragments --fix prepíše každý súbor, ktorý nie je tak, ako ho zapisovač píše.
  2. Strážca G9 (node tools/i18n.js --fragments --check). V kópii stromu v pracovnom priečinku sa vymenili dva riadky v js/realms/rokgard/i18n/sk.js a 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 in rokgard, restart_what_chains stands after restart_what_colony: run node tools/i18n.js --fragments --fix*. Na pôvodnom strome hlási „3839 keys in 9 packages … everything is fine“.
  3. Testy. tests/tools/i18n-format.test.js má test „the real catalogues: each of the 81 files …“: pre každý súbor žiada prázdny zoznam disorder, poradie kľúčov rovné Format.sortKeys a poradie Object.keys po 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.js má test „G9, the order“ s mutáciami: vymenené kľúče, skupina na zlom mieste, 10 pred 2, 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ódutools/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šenie94 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ť

VecStav
texty v balíkoch, kľúče s cestou (S1, S2)hotové, 31. 10. 2026
strom a abecedné poradie, strážca G9 a testyhotové
alias pre uložené kľúče (RENAMED, G10)hotové, 2 kľúče
S4: 36 kľúčov jadra o balíkoch ako dáta manifestovlen navrhnuté (DESIGN §112.11)
čisté jadro (M8b), tabuľka cárstiev mimo jadra (M9)nie, 94 hrán
build bez kampanenie je taký build
zmazanie 451 komentárov dávoknerobí 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.md kap. 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 --test nad 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.