Risposta rapida: PNG è per condivisione statica, non per tracciamento live
Un GitHub contribution PNG è un’immagine statica dell’attività di contributo. È adatto a portfolio, articoli, presentazioni e anteprime social che devono restare stabili.
Non trattare il PNG come fonte di verità. La fonte resta il GitHub contribution graph e le regole di GitHub. Se mancano commit nel grafico ufficiale, il PNG congela lo stesso problema.
Per un README profilo spesso è meglio una card SVG dinamica o github-profile-3d-contrib. Per una vista immersiva usa GitHub City.
PNG, SVG e visual 3D dei contributi
Il formato dipende da dove vivrà il visual. PNG è semplice ma non si aggiorna. SVG è nitido nel README. Il 3D è migliore per esplorazione e storytelling.
Scegli PNG per pubblicazione fissa, SVG per aggiornamento e GitHub City per interazione.
Scegli i dati sorgente
Inizia dal grafico ufficiale GitHub o da un generatore affidabile. Controlla username, periodo e visibilità dei contributi privati.
Usa PNG per le pubblicazioni fisse
Usa PNG per slide, pagine portfolio, illustrazioni di articoli, anteprime social o documenti che richiedono un immagine statica.
Preferisci SVG per README aggiornati
Se l immagine appare in un README e deve restare aggiornata, usa una card SVG o un asset generato dal workflow.
Usa GitHub City per esplorare
Se il visitatore deve interagire con la vista, confrontare la densità dell attività o raccontare un percorso, indirizzalo a GitHub City.
Workflow pratico per un GitHub Contribution PNG
Un buon flusso conta più del pulsante di export. Controlla prima che il grafico ufficiale racconti la storia corretta, poi esporta un immagine leggibile alla dimensione finale e aggiungi il contesto intorno all immagine.
Per un README, evita di caricare un PNG statico e dimenticarlo. Se l aggiornamento è importante, scegli SVG o un workflow automatizzato.
| Format | Idéal pour | Mise à jour |
|---|---|---|
| Image PNG de contributions | Portfolio, article, présentation, aperçu social | Instantané statique ; mise à jour manuelle |
| Carte SVG README | Sections README et badges légers | Peut se rafraîchir via service ou workflow |
| Image 3D de contributions | Visuels de profil et bilans annuels | Souvent générée par workflow ; sortie à vérifier |
| Vue 3D GitHub City | Exploration interactive et storytelling | Expérience navigateur fondée sur les données visibles |
Usi migliori di un GitHub Contribution PNG
Usa un immagine statica quando la stabilità conta più dell aggiornamento. Scegli un altro formato se il visual deve restare vivo o interattivo.
Prova per il portfolio
Un PNG funziona bene per descrivere un anno, un periodo di progetto o uno sprint preciso.
Slide di presentazione
Le slide richiedono visual stabili che non dipendano da un servizio remoto.
Illustrazione per un articolo
Il PNG sostiene la spiegazione, ma la conclusione deve restare nel testo HTML.
Attenzione nel README
I PNG statici invecchiano. Preferisci una card dinamica o una sezione template README.
Risoluzione problemi: perché il PNG sembra errato
Se l immagine sembra vuota o incompleta, diagnostica i dati prima delle impostazioni di export. Controlla e-mail di commit, branch, fork, visibilità privata e ritardo di aggiornamento.
Se l immagine è sfocata, esportala più grande e comprimila una sola volta. Non inserire testi lunghi nell immagine; lascia la spiegazione nel testo indicizzabile.
Regola per scegliere
PNG per pubblicazioni fisse, SVG o card generate per README aggiornati, GitHub City per l esplorazione interattiva.
FAQ
Come si crea un GitHub contribution PNG?
Controlla prima il grafico ufficiale o un generatore affidabile, poi esporta un immagine ad alta risoluzione quando il visual deve restare fisso.
PNG è migliore di SVG per un README GitHub?
Di solito no. SVG o le card generate restano più nitide e più facili da aggiornare.
Un PNG può mostrare contributi privati?
Solo l attività visibile o anonimizzata esposta dal grafico sorgente. Non deve rivelare dettagli dei repository privati.
Perché il mio PNG non mostra alcuni commit?
Il PNG riflette spesso il grafico sorgente. Controlla e-mail, branch, fork, privacy e tempi di aggiornamento.
Devo usare GitHub City invece di un PNG?
Usa GitHub City per una città 3D interattiva; usa PNG per un asset fisso.