Guide ai progetti

Immagine di anteprima social GitHub: dimensioni, configurazione e controlli

L’anteprima social di un repository è l’immagine che può apparire quando viene condiviso il suo link. Usala per spiegare il progetto a colpo d’occhio: un nome breve, una promessa utile e un esempio riconoscibile. Completa il README senza sostituirlo.

Redazione di GitHubStart · Aggiornato

Prepara il file giusto

Le indicazioni attuali di GitHub accettano file PNG, JPG o GIF inferiori a 1 MB. Consigliano almeno 640 × 320 pixel, con 1280 × 640 per la visualizzazione migliore. Parti dalla tela più grande in rapporto 2:1, poi controlla la leggibilità a dimensioni molto ridotte.

Per un validatore CSV immaginario, un layout chiaro potrebbe mostrare il nome del progetto, “Controlla i file CSV prima dell’importazione” e un semplice esempio che colleghi un input a un errore. Evita di comprimere un’intera sessione di terminale in una miniatura. Tieni il testo importante lontano dai bordi, nel caso in cui una piattaforma di condivisione ritagli l’immagine.

Carica l’immagine e controlla il link condiviso

Apri Settings del repository, individua Social preview, scegli Edit e carica l’immagine. Condividi l’URL pubblico del repository nella destinazione in cui lo vedrà il tuo pubblico. Controlla lì il risultato; un caricamento riuscito non garantisce che ogni piattaforma sostituisca subito un’anteprima memorizzata nella cache.

  • Conferma che l’immagine appartenga al repository che stai condividendo.
  • Controlla formato, dimensioni in pixel e dimensione del file prima del caricamento.
  • Usa un contrasto leggibile; esamina le immagini trasparenti su sfondi chiari e scuri.
  • Se l’immagine è obsoleta, conferma l’impostazione salvata del repository e verifica la cache della piattaforma di destinazione.

Mantieni l’anteprima coerente con il progetto

Usa lo stesso nome e scopo del progetto nell’immagine, nel README e nell’annuncio della versione. Se una schermata mostra una funzionalità sperimentale, indicalo oppure usa un flusso stabile. Non aggiungere conteggi di Stars, loghi di clienti o dichiarazioni di prestazioni inventati.

Rivedi l’immagine quando cambia il caso d’uso principale del progetto. Un’anteprima è uno strumento di comunicazione, non una garanzia indipendente di posizionamento, percentuale di clic o Stars GitHub.

Domande frequenti

È la stessa cosa dell’avatar del proprietario del repository?

No. L’avatar del proprietario identifica l’account. Un’anteprima social personalizzata del repository rappresenta un progetto specifico quando viene condiviso il suo link.

L’anteprima può usare uno sfondo trasparente?

GitHub supporta la trasparenza PNG. Controlla il contrasto su sfondi diversi; uno sfondo a tinta unita è una scelta pratica quando l’aspetto della destinazione è incerto.

Perché vedo ancora la vecchia anteprima dopo il caricamento?

Verifica innanzitutto che la nuova immagine sia salvata nel repository corretto. Le piattaforme possono memorizzare le anteprime nella cache; il loro aggiornamento è indipendente dall’impostazione del repository.

Riferimenti