IT

Tutorial 8 — La pagina di presentazione del gioco e la sua pubblicazione

La pagina di presentazione: site/

Una cartella games/<id>/site/ (una pagina index.html, delle immagini) diventa la pagina del gioco su questo sito, e la radice del tuo dominio se lo distribuisci a casa tua (con il gioco in play/). Esempi: Rainbow Islands, Sapiens.

  • nei colori del gioco, con le sue vere immagini: screenshot (bin/jumphp shot), i suoi sprite, i suoi tile;
  • un grande link al gioco: href="play/";
  • il posizionamento sui motori di ricerca: <title>, <meta name="description">, Open Graph (og:image da 1200 × 630), un <h1>, degli alt sulle immagini, i dati strutturati VideoGame;
  • gli indirizzi assoluti si scrivono https://{{DOMAIN}}/…: il sito li sostituisce con l'indirizzo vero;
  • leggibile su telefono (390 pixel di larghezza, senza scorrimento orizzontale).

Verificala con bin/jumphp build:site <id> poi bin/jumphp siteshot <id>.

La descrizione, in tutte le lingue

Il sito esiste in 14 lingue (fr en es de it pt nl pl ru uk tr ja zh ko): mostra la descrizione del gioco nella lingua del visitatore. Scrivila in config/game.yaml, in quante più lingue possibile (almeno fr e en):

game:
  description: "Un rompimattoni: 3 vite, un muro nuovo a ogni livello."
  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."

Senza una traduzione nella lingua del visitatore, viene mostrata la descrizione del progetto.

Il sito del gioco in altre lingue

site/index.html è la pagina nella lingua principale del gioco (il suo <html lang>). Ogni traduzione va in site/<codice>/index.html (per esempio site/en/index.html): la stessa pagina tradotta, con i percorsi relativi una cartella più su (../images/…, il gioco in ../play/). Qui il visitatore vede la pagina nella sua lingua quando esiste. Ogni pagina elenca tutte le lingue (<link rel="alternate" hreflang="…">) e offre un piccolo menu delle lingue; sitemap.xml dà un indirizzo per lingua. Il tuo Claude sa come fare (AGENTS.md §13 di JumPHP).

assets/thumbnail.png (16:9). Altrimenti il sito prende l'immagine og:image della pagina di presentazione, poi l'icona del gioco e, in mancanza, fotografa il gioco stesso in un browser.

Cosa aggiunge il sito a ogni gioco

  • Installa: ogni gioco si installa come un'applicazione (su telefono e su computer), con la sua icona (assets/icon.png);
  • Condividi: il foglio di condivisione del telefono, o i social network su computer;
  • i voti dei giocatori (da 1 a 5 stelle, senza account) e il contatore delle partite;
  • i sorgenti e l'editor online;
  • le versioni (🕘): ogni commit che ha cambiato il gioco. I giocatori hanno sempre l'ultima versione pubblicata; una versione precedente si può rigiocare, riprendere nella sandbox, ripristinare (il suo autore: dal suo editor, «Invia su GitHub») o forkare;
  • i commenti, la cassetta delle idee e i problemi segnalati dai giocatori, con o senza account. I messaggi anonimi compaiono solo dopo la tua approvazione. La campanella 🔔 in alto nel sito conta i nuovi messaggi sui tuoi giochi e quelli in attesa di approvazione; la sua pagina (Notifiche) li elenca tutti, con i pulsanti ✓ Approva, Segna come risolto (per un problema) ed Elimina.

Pubblicare

Ogni push sul branch principale del tuo repository viene pubblicato entro un minuto. Nello Studio, la pagina del progetto mostra lo stato della pubblicazione, gli errori, e permette di nascondere il gioco dal catalogo.