Resposta rápida: PNG é para compartilhamento estático, não para acompanhamento vivo
Um GitHub contribution PNG é uma imagem estática da atividade de contribuições. Ele funciona bem em portfólios, artigos, apresentações e previews sociais que devem permanecer estáveis.
Não trate o PNG como fonte da verdade. A fonte ainda é o GitHub contribution graph e as regras do GitHub. Se commits ou atividade privada faltam no gráfico oficial, o PNG apenas congela o problema.
Para README de perfil, um cartão SVG dinâmico ou github-profile-3d-contrib costuma ser melhor. Para uma visão imersiva, abra GitHub City.
PNG vs SVG vs visuais 3D de contribuições
O formato correto depende de onde o visual será usado. PNG é simples, mas não atualiza sozinho. SVG fica nítido no README. 3D é melhor para exploração e narrativa de portfólio.
Use PNG para publicação fixa, SVG para atualização e GitHub City para exploração interativa.
Escolha os dados de origem
Comece pelo gráfico oficial do GitHub ou por um gerador confiável. Verifique o nome de usuário, o período e a visibilidade das contribuições privadas.
Reserve PNG para publicações fixas
Use PNG em slides, páginas de portfólio, ilustrações de artigos, previews sociais ou documentos que exigem uma imagem estática.
Prefira SVG para README atualizados
Se a imagem aparecer em um README e precisar continuar atualizada, use um cartão SVG ou um asset gerado por workflow.
Use GitHub City para explorar
Se o visitante precisar interagir com a visão, comparar a densidade da atividade ou contar uma trajetória, encaminhe-o para o GitHub City.
Fluxo prático para um GitHub Contribution PNG
Um bom fluxo é mais importante do que o botão de exportação. Verifique primeiro se o gráfico oficial mostra a história correta, depois exporte uma imagem legível no tamanho final e adicione contexto ao redor dela.
Em um README, evite enviar um PNG estático e esquecê-lo. Se a atualização for importante, escolha SVG ou um workflow automatizado.
| Formato | Melhor para | Atualização |
|---|---|---|
| Imagem PNG de contribuições | Portfólios, artigos, slides e previews sociais | Instantâneo estático; atualize manualmente quando os dados mudarem |
| Cartão SVG para README | Seções de README e badges leves | Pode atualizar por serviço hospedado ou workflow |
| Imagem 3D de contribuições | Visuais de perfil e retrospectivas anuais | Normalmente gerada por workflow; confira a saída |
| Visualização 3D GitHub City | Exploração interativa e narrativa de portfólio | Experiência no navegador baseada em dados visíveis |
Melhores usos para um GitHub Contribution PNG
Use uma imagem estática quando a estabilidade for mais importante que a atualização. Escolha outro formato se o visual precisar continuar vivo ou interativo.
Prova de portfólio
Um PNG funciona bem para descrever um ano, período de projeto ou sprint específico.
Slide de apresentação
Slides precisam de visuais estáveis que não dependam de serviços remotos.
Ilustração de artigo
O PNG apoia a explicação, mas a conclusão deve permanecer em texto HTML.
Cuidado no README
PNGs estáticos envelhecem. Prefira um cartão vivo ou uma seção de README template.
Solução de problemas: por que o PNG parece errado
Se a imagem parecer vazia ou incompleta, diagnostique os dados antes das configurações de exportação. Verifique e-mail de commit, branch, forks, visibilidade privada e atraso de atualização.
Se a imagem estiver desfocada, exporte em tamanho maior e compacte apenas uma vez. Não coloque textos longos na imagem; mantenha a explicação em texto indexável.
Regra de decisão
PNG para publicação fixa, SVG ou cartões gerados para README atualizado, GitHub City para exploração interativa.
FAQ
Como criar um GitHub contribution PNG?
Confira o gráfico oficial ou um gerador confiável, depois exporte uma imagem de alta resolução quando o visual precisar ficar fixo.
PNG é melhor que SVG para README?
Geralmente não. SVG ou cartões gerados são mais nítidos e mais fáceis de atualizar.
Um PNG pode mostrar contribuições privadas?
Somente a atividade visível ou anonimizada exposta pelo gráfico fonte. Ele não deve revelar detalhes de repositórios privados.
Por que meu PNG não mostra alguns commits?
O PNG normalmente reflete o gráfico fonte. Verifique email, branch, forks, privacidade e tempo de atualização.
Devo usar GitHub City em vez de PNG?
Use GitHub City para uma cidade 3D interativa; use PNG para um asset fixo.