結論：PNG は固定共有向きで、ライブ更新向きではありません
GitHub contribution PNG は貢献活動を固定した画像です。公開後に変わらないポートフォリオ、記事、スライド、SNS プレビューに向いています。
PNG を真実の元データとして扱わないでください。元データは GitHub contribution graph と GitHub のルールです。公式グラフで欠けている活動は、PNG にしても欠けたままです。
プロフィール README では、動的 SVG カードや github-profile-3d-contrib の方が向く場合があります。3D 表現なら GitHub City を使います。
PNG・SVG・3D 貢献ビジュアルの使い分け
形式は表示場所で決めます。PNG は扱いやすい一方、自動更新されません。SVG は README で鮮明に表示でき、3D は探索やポートフォリオ表現に向いています。
固定公開なら PNG、更新性なら SVG、操作して見せるなら GitHub City を選びます。
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.
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é.
| 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 |
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.
Preuve de portfolio
Un PNG fonctionne bien pour décrire une année, une période de projet ou un sprint précis.
Slide de présentation
Les slides exigent des visuels stables qui ne dépendent pas d’un service distant.
Illustration d’article
Le PNG soutient l’explication, mais la conclusion doit rester dans le texte HTML.
Attention dans un README
Les PNG statiques vieillissent. Préférez une carte dynamique ou une section README template.
トラブルシューティング：PNG が正しく見えない理由
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
Comment créer un GitHub contribution PNG ?
Vérifiez d’abord le graphique officiel ou un générateur fiable, puis exportez une image haute résolution quand le visuel doit rester fixe.
PNG est-il meilleur que SVG pour un README GitHub ?
Généralement non. SVG ou les cartes générées restent plus nettes et plus faciles à actualiser.
Un PNG peut-il montrer des contributions privées ?
Seulement l’activité visible ou anonymisée que le graphique source expose. Il ne doit pas révéler de détails de dépôts privés.
Pourquoi mon PNG ne montre-t-il pas certains commits ?
Le PNG reflète souvent le graphique source. Vérifiez email, branche, fork, confidentialité et délai de mise à jour.
Faut-il utiliser GitHub City plutôt qu’un PNG ?
Utilisez GitHub City pour une ville 3D interactive ; utilisez PNG pour un asset fixe.