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.
Choisir les données source
Commencez par le graphique officiel GitHub ou par un générateur fiable. Vérifiez le nom d’utilisateur, la période et la visibilité des contributions privées.
Réserver PNG aux publications fixes
Utilisez PNG pour des slides, pages portfolio, illustrations d’article, aperçus sociaux ou documents où une image figée est attendue.
Préférer SVG pour les README vivants
Si l’image apparaît dans un README et doit rester fraîche, utilisez une carte SVG ou un asset généré par workflow.
Utiliser GitHub City pour explorer
Si le visiteur doit manipuler la vue, comparer la densité d’activité ou raconter un parcours, envoyez-le vers GitHub City.
Fluxo prático para um GitHub Contribution PNG
Un bon flux compte plus que le bouton d’export. Vérifiez d’abord que le graphique officiel raconte la bonne histoire, puis exportez une image lisible à la taille finale et ajoutez le contexte autour de l’image.
Pour un README, évitez de téléverser un PNG statique puis de l’oublier. Si la fraîcheur compte, choisissez SVG ou un workflow automatisé.
| 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
Utilisez une image statique quand la stabilité compte plus que la fraîcheur. Choisissez un autre format si le visuel doit rester vivant ou interactif.
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
Si l’image paraît vide ou incomplète, diagnostiquez les données avant les réglages d’export. Vérifiez email de commit, branche, forks, visibilité privée et délai d’actualisation.
Si l’image est floue, exportez plus grand puis compressez une seule fois. Ne placez pas de longs textes dans l’image ; gardez l’explication en texte indexable.
Règle de décision
PNG pour publication fixe, SVG ou cartes générées pour README vivant, GitHub City pour l’exploration interactive.
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.