časť 48
Ako vznikla stránka audamir.io a jej prepojenie s hrou
Z blogu o hre sa 1. a 2. novembra 2026 stal web s jazykmi, hlavnou stránkou, zoznamom zmien a kartou hráča medzi stránkou a hrou.
Blog Kocky sú hodené bol do 1. novembra 2026 priečinok so štyridsiatimi súbormi Markdownu a šiestimi nástrojmi. Do 2. novembra večera z neho vznikol web audamir.io: hlavná stránka s tlačidlom PLAY, zoznam zmien hry, blog vo viacerých jazykoch, stránka 404, obrázok na zdieľanie a dohoda s hrou o tom, čo si stránka a hra vymieňajú. Tento článok hovorí, ako sa ktoré rozhodlo a prečo.
Z priečinka na web
Prvý commit repozitára z 1. novembra mal 40 článkov (01-dvadsat-rokov.md až 40-nahlady-v-nastaveniach.md), blog.json, planned.json, assets/ a šesť nástrojov. Žiadne jazyky, žiadna hlavná stránka, žiadne nasadenie.
Odpoveď na otázku, ako to urobiť viacjazyčne bez prepisovania, bola jedna veta: číslo článku je jeho identita vo všetkých jazykoch. Súbor sa volá posts/<jazyk>/NNN-slug.md, rovnaké číslo v inom jazyku je preklad toho istého článku. Slug sa môže líšiť, lebo adresa je /<jazyk>/blog/<NNN>-<slug>.html. Kontrola odmietne preklad bez originálu.
Číslo sa po zverejnení nemení, lebo je súčasťou odkazu, ktorý si niekto uloží alebo pošle ďalej. Kým je článok koncept, číslo sa dá zmeniť.
V blog.json je deväť jazykov, zapnuté sú dva (sk, en). Nový jazyk sa zapne v konfigurácii a dostane vlastný katalóg; kontrola odmietne katalóg, ktorému chýba kľúč.
Generátor je čistý Node bez závislostí (Node 18 a novší). Výstup sú statické súbory, na serveri netreba PHP ani Node. Stránky majú relatívne adresy, takže sa dajú otvoriť aj zo súboru.
Hlavná stránka a zoznam zmien
Hlavná stránka má popis, panel s tlačidlom PLAY, zástupný blok na video, posledné záznamy zoznamu zmien a šesť najnovších článkov.
Video sa nenačíta samo. Kým video.src v blog.json je prázdny, ukazuje sa zástupný blok; po vyplnení sa video načíta až po kliknutí. Poskytovateľ nie je rozhodnutý (YouTube bez cookies alebo vlastný súbor).
Zoznam zmien sa nepíše znova, číta sa zo zdroja hry. tools/changelog.js načíta js/data/changelog.js z repozitára hry (cesta gameRepo v blog.json). Stránka tak nemôže povedať iné než hra. Cena: zoznam sa číta v čase zostavenia, nie z nasadenej hry. Poistka je voľba --changelog-up-to (pri build:site --match-game), ktorá novšie záznamy skryje. Dnes (3. 11. 2026) skript vypísal varovanie: skopíroval hru 0.90.5, repozitár hry má 0.97.1. Zoznam má 88 záznamov a je po anglicky.
Ikona, ktorá je kópia
Ikona stránky je ikona hry (vikingská prilba na doske), od 1. novembra nahradila kocku.
- Ikona je kópia, nie odkaz. Šesť súborov sa kopíruje príkazom
npm run sync:icons, lebo stránka sa musí dať zložiť aj bez repozitára hry. - **Vloženie cez
<img>, nikdy ako inline SVG.** Ikony hry majú vlastný<style>, ktorý by ovplyvnil celú stránku. Cena: SVG nevidí prepínač vzhľadu stránky. Pri zhode „systém svetlý, stránka ručne tmavá“ je v hlavičke svetlá dlaždica na tmavom pozadí. Čitateľné, nie dokonalé.
Panel PLAY ukazuje prilbu, kým hra nezapíše kartu hráča.
Karta hráča: malý dokument, nie prístup do hry
Stránka a hra sú na jednej doméne a zdieľajú localStorage. Stránka chcela ukázať, kto hrá: meno hrdinu, avatar a číslo, ktoré hovorí, ako ďaleko je. Rozhodnutie: jeden malý, verzovaný, tolerantne čítaný dokument, kľúč audamir.card, ktorý píše hra a číta stránka. Tvar je v docs/GAME-CARD.md.
Prečo nie čítať profil hry? Toto je odvodené z návrhu, nie citát z dokumentov:
- Stránka nemá načítať kód hry. Má byť statická, bez skriptov tretích strán. Čítať jeden kľúč je lacné, spustiť hru kvôli menu nie.
- Vnútro úložiska hry sa mení. Karta je tvar, ktorý sa drží stabilný a rozširuje sa len pridávaním polí.
- Karta je zhrnutie, nie zdroj pravdy. Keď sa stratí, hra ju znova zapíše z profilu; nič v hre ju nečíta (DESIGN §131.5).
Dôkaz na bod 2 prišiel o deň neskôr: hra 2. novembra premenovala predponu kľúčov z diceWars. na audamir.. Karta to nezasiahlo. Zasiahol jediný druhý kľúč, ktorý stránka číta, nastavenia hry (kvôli jazyku). Stránka ho musela hľadať pod oboma menami.
Prečo audamir.card a nie diceWars.card: karta je rozhranie k stránke, nie vnútorný stav hry. Hra nesmie nazvať žiadny svoj kľúč theme, lang ani card; test v tests/pages.test.js to stráži.
Čo karta nesie
Karta je JSON v1. Stránka toleruje chýbajúce aj neznáme polia.
| Pole | Povinné | Pravidlo čítania na stránke |
|---|---|---|
v | áno | verzia tvaru, teraz 1 |
level | áno | 1 až 999; zobrazí sa, keď karta nemá platnú reputáciu |
reputation | nie | celé číslo 1 až 9999; ak platí, panel ukáže reputáciu namiesto úrovne a pruhu XP |
name | nie | najviac 40 znakov, len ako text |
xp, xpNext | nie | pruh postupu úrovne |
avatar.image | nie | data: URL (PNG, WebP alebo SVG), najviac 20 000 znakov |
avatar.label | nie | popis obrázka pre čítačky obrazovky |
realm, gameVersion, updated | nie | informatívne; stránka ich nepoužíva |
Stránka karte nedôveruje. AudamirCard.parse() pri zlom JSON-e, nie-objekte alebo chýbajúcom v alebo level vráti „bez karty“. Všetko sa vkladá cez textContent; src obrázka sa nastaví len pri data: URL typu PNG, WebP alebo SVG v base64. Pri akejkoľvek chybe ostane všeobecný obrázok s prilbou a PLAY.
Obrázok kreslí hra
Avatar je hotový obrázok, ktorý pripraví hra. Stránka nemá vlastné kreslenie prilieb: 21 foriem by sa muselo udržiavať na dvoch miestach.
Hra kreslí prilbu štýlmi, takže <img src="data:…"> sa k nim nedostane. Riešenie z DESIGN §131.4: js/ui/helmet-image.js vyrobí samostatné SVG a farby, ktoré prehliadač vypočítal, zapíše ako triedy v jeho <style>. Dĺžka je od 9 474 znakov (forma 1) po 13 238 (forma 21), pod limitom 20 000.
Ktorá úroveň patrí na kartu
Hra nemá jedinú úroveň: každé cárstvo má vlastnú (R3a). Jediné číslo nad cárstvami je reputácia v Asgarde, súčet úrovní, z ktorej vzniká prilba aj titul.
Zvolené pravidlo (DESIGN §131.2): na karte je úroveň cárstva, v ktorom je hrdina najďalej; pri remíze cárstvo s väčším postupom, potom Kastgard, potom prvý registrovaný. Hráč bez hier má úroveň 1 Kastgardu. Obrázok je prilba celej reputácie. Zamietnuté boli tri možnosti: reputácia ako úroveň (číslo bez pruhu, ktoré žiadna obrazovka hry nevolá úrovňou), cárstvo hrané naposledy (karta by skákala) a vždy Kastgard (hráč, čo hrá len Rokgard, by mal úroveň 1). Cena: prilba je celý hrdina a úroveň jedno cárstvo, dve čísla, ktoré sa nezhodujú, ako na domovskej obrazovke hry.
Stránka 2. novembra chcela na paneli reputáciu v Asgarde (DESIGN §131.8). Riešenie je aditívne: karta dostala pole reputation, v ostalo 1. Ak pole chýba (kartu napísala staršia hra), panel spadne na úroveň s pruhom.
Pri reputácii 0 sa pole vynechá: „1“ pre hráča bez hier by dala rovnakú kartu hráčovi, čo nehral nič, aj hráčovi s jednou hrou.
Kto a kedy kartu píše
Len keď hra beží na webe (Build.target je web). Zápis nastane na konci App.init a po zmene profilu alebo nastavení, a to len keď sa niečo zmenilo. V karte nie je nič osobné okrem mena, ktoré hráč dal hrdinovi; hra dovolí 16 znakov, karta 40.
Overené (DESIGN §131.6): testy tvaru proti pravidlám čítania, všetkých 21 foriem prilby proti index.html, úložisko, ktoré odmieta zápis, a 44 mutantov; šesť prežilo prvé testy, po doplnení všetky zabité. V Chromiu z panela aplikácie: čistý profil s ?lang=sk zapísal kartu s úrovňou 1; profil úrovne 31 dal riadok „Ivka, Level 31, 100 / 1575 XP“.
?lang= v adrese: omyl, ktorý ukázal prehliadač
PLAY pridáva k adrese hry jazyk stránky (/game/?lang=sk). Pôvodné pravidlo znelo: adresa sa pýta, nerozhoduje (uložený jazyk vyhráva).
Pravidlo prešlo testami, ale zlyhalo na čistom origine v skutočnom prehliadači (DESIGN §131.9): ?lang=sk na prázdnom úložisku otvorilo slovenčinu, no akákoľvek zmena nastavenia (napríklad vypnutie zvuku) zapísala celé nastavenia vrátane lang. Odvtedy uložený jazyk vyhrával nad adresou, hoci hráč jazyk nikdy nezvolil. Kliknutie na EN a potom PLAY otvorilo hru po slovensky.
Opravené pravidlo je schválené: platné ?lang=xx vyhráva nad uloženým jazykom, hra ho uloží a vymaže parameter z adresy (history.replaceState). Pri neplatnom parametri sa nič neuloží. Odkazy, ktoré hráč posiela ďalej (#c=, #R=, text výsledku), parameter nenesú, inak by ten, kto zdieľa, vnútil svoj jazyk každému, kto odkaz otvorí.
Dôkazy (DESIGN §131.9): 28 mutantov (26 zabitých, dva neboli mutantmi a vyhodili sa z kódu) a dáta starého kódu: bez ?lang= ostanú nastavenia bajt po bajte.
Aký jazyk otvorí stránka
Rozcestník / otvorí /{jazyk}/ podľa štyroch krokov: (1) jazyk naposledy zvolený na stránke (audamir.lang), (2) jazyk hry z jej nastavení, (3) jazyk prehliadača, (4) en. Prvý krok pôvodné zadanie nemalo; pridal ho tvorca stránky, lebo prepínač by inak po návrate na / nič neznamenal.
Druhý krok číta audamir.settings, potom diceWars.settings. Rozhodnutie: kľúč bez čitateľného jazyka sa preskočí, lebo omyl rozcestníka stojí najviac nesprávny jazyk, ktorý návštevník prepne. Každé čítanie má vlastné try/catch. Nasadiť sa to má pred hrou s novými kľúčmi.
Odkaz na hru, ktorý je súbor
Odkaz je relatívny: zo sk/index.html je to ../game/index.html?lang=sk. Dôvod: dist/site/ sa dá prezerať aj zo súboru, kde absolútne /game/ vedie do koreňa disku. Cena: hra má z webu dve adresy tej istej stránky (/game/index.html?lang=sk a /game/?lang=sk), obe fungujú. Zo súboru nefunguje karta, lebo každá stránka z file:// má vlastný pôvod. Skutočný náhľad aj s kartou je npm run serve -- --site.
Menej viditeľné rozhodnutia
Názvy príkazov. Pôvodné build stavalo náhľad aj web. Commit z 2. 11. ich rozdelil: npm run build:preview robí náhľad do dist/preview/ a nenahráva sa; npm run build:site robí celý web a je jediným vstupom nasadenia. npm run build zanikol.
Stránka 404. Hosting ju ukáže na ľubovoľnej adrese, preto má všetky adresy v koreni (/assets/style.css). Je bez ohľadu na jazyk, nie je v sitemape a má noindex.
Ochrana čísel zverejnených článkov. Pravidlo bolo od 1. novembra len veta v README. Commit z 2. 11. ho previedol na published.json po jazykoch. node tools/check.js zlyhá, keď sa zapísané číslo alebo slug zmení, článok zmizne alebo sa vráti na koncept, aj keď je zverejnený a v zozname ešte nie je. Dnes je v zozname 25 slovenských záznamov a anglický je prázdny; zapisuje ho npm run published -- --add. Zoznam hovorí, čo sa považuje za zverejnené, nie čo je na webe.
Obrázok na zdieľanie. assets/og-image.png (1 200 × 630 px) je len ikona hry uprostred pozadia v odtieňoch ikony. Žiadny text ani vymyslené logo. Nástroj tools/og-image.js píše PNG sám.
Dobové snímky
Snímky sú z prvého commitu, v ktorom príslušná časť webu existuje.






Čo je rozhodnuté a čo ostáva otvorené
Rozhodnuté: číslo je identita článku vo všetkých jazykoch; karta audamir.card v1 s poľom reputation; adresa jazyka vyhráva a hra ho uloží (so schválením autora); stránka číta nastavenia hry pod dvoma menami; zoznam zmien sa číta zo zdroja hry; ikona je kópia; published.json je po jazykoch.
Čaká na mňa: zapnúť anglický blog (otázka 5); schváliť texty hlavnej stránky (16); vybrať poskytovateľa videa (17); doplniť právnu stránku (19).
Čo si z toho odnášam
- Rozhranie medzi dvoma vecami má byť malý dokument, nie prístup do vnútra. Karta prežila premenovanie kľúčov hry; jediný kľúč, ktorý stránka čítala priamo, si vynútil zmenu kódu aj testu.
- Rozhranie sa rozširuje pridávaním polí.
reputationprišlo bez zmenyv. - **Chybu v
?lang=našiel skutočný prehliadač na čistom origine, nie test.** Test overoval pravidlo, ktoré bolo samo chybné. - Hodnota uložená bez rozhodnutia nie je voľba. Uložený
langbol predvolená hodnota zapísaná pri zmene iného nastavenia. - Zverejnené číslo je zmluva, tak ju má strážiť nástroj, nie pamäť.
Zdroje a poznámky
git logrepozitária stránky (21 commitov, 1. až 2. novembra 2026);README.md,docs/GAME-CARD.md,docs/OPEN-QUESTIONS.md.- Dokumenty hry (0.97.1 v čase písania):
docs/DESIGN.md§131.1 až §131.9,docs/ROADMAP.mdkapitola 31. - Merania 3. 11. 2026:
node tools/build-site.js(83 súborov, 25 článkov, 88 záznamov). Čísla z DESIGN sú prevzaté bez prepočtu. - Súvisiace články: Dvadsať rokov, Políčka, Kmene: kópia, ktorá sa dá zmerať.