Moje kocky – stránka projektu

English version below

Stránka na stiahnutie Moje kocky Desktop, nekomerčnej evidencie zbierky LEGO® setov pre Windows. Beží na GitHub Pages: https://jakubmatisak.github.io/moje-kocky/.

Súvisiace repozitáre: moje-kocky-desktop (program pre Windows a inštalátor) a moje-kocky-webapp (webová verzia na vlastný server).

Obsah repozitára

Je to jeden statický súbor HTML bez frameworku a bez zostavovania:

index.html                 obsah, slovensky aj anglicky (.sk / .en), SEO v <head>
en/index.html              anglická stránka, vyrobená z index.html (scripts/build-en.mjs)
scripts/build-en.mjs       vyrobí en/index.html: anglický <head>, cesty o priečinok vyššie
assets/style.css           farby a rozloženie ako v programe, tmavý režim podľa systému alebo voľby
assets/site.js             jazyk (SK = koreň, EN = en/), svetlý/tmavý režim (localStorage „theme“), galéria
assets/fonts/              Roboto (OFL-1.1, pozri OFL.txt), uložené tu, nie z Google Fonts
assets/img/                snímky desktopu s ukážkovou zbierkou (vymyslené ručné ceny),
                           *-male = náhľady, og.jpg = obrázok na zdieľanie 1200×630
sitemap.xml                mapa stránky pre vyhľadávače (obe jazykové verzie)
third-party-notices.txt    licencie knižníc v inštalátore (z packaging/notices.py desktopu)

Po každej zmene index.html spusti node scripts/build-en.mjs a commitni aj en/index.html. Náhľad: python -m http.server v tomto priečinku. Zverejnenie: GitHub Pages z vetvy main, priečinok / (root).

Pravidlá, ktoré stránka dodržiava

• Žiadne cookies, analytika ani cudzie servery. V prehliadači ostáva len voľba režimu (localStorage.theme), o ktorú si návštevník sám požiadal. Písmo, ikony aj skripty sú súčasťou stránky, takže IP návštevníka nikam neodchádza. Ak by pribudlo čokoľvek také, treba najprv lištu so súhlasom.
• LEGO® Fair Play. Značka len ako prídavné meno a vždy so ®, nikdy logo LEGO ani „LEGO“ v adrese; v päte upozornenie, že LEGO Group stránku nesponzoruje.
• Kredit všetkým službám a knižniciam. Služby majú kartu v Licenciách, knižnice sú v third-party-notices.txt (odkaz v Licenciách); pri novej závislosti v desktope ho pregenerovať.
• Texty sú v oboch jazykoch. Nový text = <span class="sk"> aj <span class="en">.
• Po zmene CSS alebo JS zvýš ?v= v odkazoch v index.html, inak prehliadač podrží starý súbor.

Vyhľadávače (SEO)

• Každý jazyk má vlastnú adresu: koreň je slovensky, en/ anglicky. Roboty a četovacie aplikácie (Messenger, WhatsApp) JavaScript nespúšťajú, preto má anglická stránka anglický titulok, popis, Open Graph aj popisy obrázkov priamo v súbore. Staré odkazy ?lang=en presmeruje site.js na en/.
• <head> má kanonickú adresu, hreflang, Open Graph a Twitter kartu s obrázkom assets/img/og.jpg (aj typ a popis obrázka) a štruktúrované dáta SoftwareApplication (zadarmo, Windows, verzia, veľkosť) v JSON-LD.
• Pri novom vydaní zmeň v index.html odkaz na stiahnutie, text „Verzia …“, softwareVersion a dateModified a spusti node scripts/build-en.mjs.
• sitemap.xml obsahuje obe verzie. robots.txt na podstránke projektu vyhľadávače nečítajú, preto tu nie je; mapu stránky treba odoslať v Google Search Console.
• Pri zmene obsahu uprav lastmod v sitemap.xml a popisy v <head> aj v site.js (TEXT).

Licencia

Obsah a kód stránky: MIT. Písmo Roboto: SIL Open Font License 1.1. Snímky obsahujú obrázky výrobkov, ktoré sú chránené autorským právom LEGO Group. LEGO® je ochranná známka skupiny spoločností LEGO Group, ktorá túto stránku nesponzoruje, neautorizuje ani neschvaľuje.

---

Moje kocky – project website (English)

The download page for Moje kocky Desktop, a non-commercial tracker for LEGO® set collections on Windows (“Moje kocky” is Slovak for “My bricks”). It runs on GitHub Pages: https://jakubmatisak.github.io/moje-kocky/ (English version: https://jakubmatisak.github.io/moje-kocky/?lang=en).

Related repositories: moje-kocky-desktop (the Windows program and installer) and moje-kocky-webapp (the web version for your own server).

What is in this repository

A single static HTML page with no framework and no build step:

index.html                 content in Slovak and English (.sk / .en), SEO in <head>
en/index.html              the English page, generated from index.html (scripts/build-en.mjs)
scripts/build-en.mjs       generates en/index.html: English <head>, paths one folder up
assets/style.css           colours and layout matching the app, dark mode from the system or the toggle
assets/site.js             language (SK = root, EN = en/), light/dark mode (localStorage “theme”), gallery
assets/fonts/              Roboto (OFL-1.1, see OFL.txt), served from here, not from Google Fonts
assets/img/                desktop screenshots of a sample collection (made-up manual prices),
                           *-male = thumbnails, og.jpg = 1200×630 sharing image
sitemap.xml                sitemap for search engines (both language versions)
third-party-notices.txt    licences of the libraries in the installer (from the desktop's packaging/notices.py)

Preview: python -m http.server in this folder. Publishing: GitHub Pages from the main branch, folder / (root).

This is the beginning of the README. Read the rest at the original. Read the full README ↗