Samouczek 8 — Strona główna gry i jej publikacja

Strona główna: `site/`

Folder games/<id>/site/ (strona index.html, obrazy) staje się stroną gry w tym serwisie i korzeniem twojej domeny, jeśli wdrażasz ją u siebie (gra jest wtedy w play/). Przykłady: Rainbow Islands, Sapiens.

w kolorach gry, z jej prawdziwymi obrazami: zrzutami ekranu (bin/jumphp shot), jej sprite'ami, kafelkami;
duży link do gry: href="play/";
pozycjonowanie: <title>, <meta name="description">, Open Graph (og:image 1200 × 630), <h1>, alt przy obrazach, dane strukturalne VideoGame;
adresy bezwzględne zapisuje się jako https://{{DOMAIN}}/…: serwis zastępuje je prawdziwym adresem;
czytelna na telefonie (390 pikseli szerokości, bez przewijania poziomego).

Sprawdź ją poleceniami bin/jumphp build:site <id> i bin/jumphp siteshot <id>.

Opis, we wszystkich językach

Serwis istnieje w 14 językach (fr en es de it pt nl pl ru uk tr ja zh ko): pokazuje opis gry w języku odwiedzającego. Napisz go w config/game.yaml, w jak największej liczbie tych języków (co najmniej fr i en):

game:
  description: "Gra w rozwalanie cegieł: 3 życia, nowy mur na każdym poziomie."
  descriptions:
    fr: "Un casse-briques : 3 vies, un nouveau mur à chaque niveau."
    en: "A brick breaker: 3 lives, a new wall every level."
    es: "Un rompeladrillos: 3 vidas, un muro nuevo en cada nivel."

Bez tłumaczenia na język odwiedzającego wyświetlany jest opis projektu.

Strona gry w innych językach

site/index.html to strona w głównym języku gry (jej <html lang>). Każde tłumaczenie trafia do site/<kod>/index.html (na przykład site/en/index.html): ta sama strona przetłumaczona, ze ścieżkami względnymi o jeden folder wyżej (../images/…, gra w ../play/). Tutaj odwiedzający widzi stronę w swoim języku, jeśli istnieje. Każda strona wymienia wszystkie języki (<link rel="alternate" hreflang="…">) i ma małe menu języków; sitemap.xml podaje jeden adres na język. Twój Claude wie, jak to zrobić (AGENTS.md §13 JumPHP).

Obraz w katalogu

assets/thumbnail.png (16:9). W razie braku serwis bierze obraz og:image ze strony głównej, potem ikonę gry, a w ostateczności sam fotografuje grę w przeglądarce.

Co serwis dodaje do każdej gry

Zainstaluj: każda gra instaluje się jak aplikacja (na telefonie i na komputerze), ze swoją ikoną (assets/icon.png);
Udostępnij: arkusz udostępniania telefonu lub media społecznościowe na komputerze;
oceny graczy (od 1 do 5 gwiazdek, bez konta) i licznik rozgrywek;
kod źródłowy i edytor online;
wersje (🕘): każdy commit, który zmienił grę. Gracze zawsze dostają najnowszą opublikowaną wersję; starszą można ponownie zagrać, wziąć do piaskownicy, przywrócić (autor: ze swojego edytora, „Wyślij na GitHub”) albo sforkować;
komentarze, skrzynka pomysłów i problemy zgłaszane przez graczy, z kontem lub bez. Anonimowe wiadomości pojawiają się dopiero po zatwierdzeniu przez ciebie. Dzwonek 🔔 na górze serwisu zlicza nowe wiadomości o twoich grach i te, które czekają na zatwierdzenie; jego strona (Powiadomienia) wyświetla je wszystkie, z przyciskami ✓ Zatwierdź, Oznacz jako rozwiązany (dla problemu) i Usuń.

Publikacja

Każdy push do głównej gałęzi twojego repozytorium jest publikowany w ciągu minuty. W Studiu strona projektu pokazuje stan publikacji, błędy i pozwala ukryć grę w katalogu.