短い答え: GitHub City は contribution graph を基準にします
GitHub contribution graph は、プロフィールに表示されるカレンダー型の活動チャートです。条件を満たすコミット、pull request、issue、review などが含まれますが、すべての Git 操作をそのまま並べたログではありません。
GitHub City にとって重要なのは、3D city が利用できる活動データ以上には完全になれないことです。公式グラフでコミットが欠けている場合、生成された city も空に見えたり低く見えたりすることがあります。
実用的な順序は、まず公式グラフを確認し、GitHub のルールを満たすか確認し、必要なら更新を待ち、その後 GitHub City や他の 3D GitHub contribution graph tool で見せ方を整えることです。
GitHub contribution graph には何が数えられる?
GitHub の公式ルールは具体的です。3D 可視化を調べる前に、特に重要な確認点をまとめます。
| 活動 | 数えられる条件 | 確認すること |
|---|---|---|
| Commits | アカウントに関連付けられ、検証済みメールを使い、対象リポジトリの対象ブランチに入った場合に数えられます。 | コミットメール、default または gh-pages branch、リポジトリ公開状態、fork かどうか。 |
| Pull requests | 対象リポジトリで作成され、GitHub アカウントに紐づく場合に数えられます。 | PR を開いたアカウント、リポジトリ状態、PR の可視性。 |
| Issues and discussions | 対象リポジトリで発生し、アカウントと紐づく場合に数えられることがあります。 | リポジトリの可視性とプロフィール活動への表示。 |
| Code reviews | 対象リポジトリの pull request に紐づく review は数えられることがあります。 | レビューした PR、リポジトリの対象性、使ったアカウント。 |
| Private contributions | 非公開 contribution 表示を有効にした場合、匿名化された四角として表示されることがあります。 | プロフィール設定と、詳細ではなく匿名カウントを期待しているか。 |
GitHub のコミットが表示されない理由
グラフが正しく見えないときは、この順序で確認します。外部 visualizer を疑う前に、多くの問題を切り分けられます。
コミットメールを確認
GitHub はコミットメールをアカウントに関連付ける必要があります。職場メール、入力ミス、未検証メールでは表示されない場合があります。
ブランチとリポジトリを確認
対象ブランチと対象リポジトリに入っている必要があります。未マージ branch、fork、対象外リポジトリは反映されないことがあります。
非公開 contribution 設定を確認
非公開作業は詳細が表示されません。緑のグラフに反映したい場合は、プロフィールの非公開 contribution 設定を見直します。
更新を待つ
最近の活動は反映まで時間がかかることがあります。push 直後なら、少し待って再確認します。
公式プロフィールと比較
公式プロフィールに表示されない作業は、GitHub City や GitHub Skyline などにも表示されない可能性があります。
非公開リポジトリの contribution は緑のグラフに影響する?
非公開リポジトリでの活動は、GitHub のプライバシールールの範囲でのみ contribution graph に影響します。非公開 contribution の表示を有効にしている場合、活動があったことは見えても、リポジトリ名や詳細は公開されません。
ポートフォリオではこの違いが重要です。濃いグラフは継続性を示せますが、非公開作業の内容を正確に証明するものではありません。同様に、GitHub 3D contribution graph は活動のリズムと密度を伝えるもので、完全な監査ログではありません。
ポートフォリオの考え方
非公開活動を視覚的に反映したい場合は設定を有効にし、重要な非公開作業は履歴書やプロジェクト説明で別途説明します。
GitHub City と 3D コントリビューション可視化ツールへの影響
GitHub City は contribution pattern を city のようなシーンに変換します。見せやすくなる一方で、データの欠けも目立ちます。1 週間分の活動が欠けるだけで、低い区画として見えることがあります。
3D city を共有する前に、公式プロフィールグラフを基準にします。緑のグラフが正しければ、3D 表示は強いストーリーテリングの層になります。緑のグラフが誤っている場合は、まず元データを直します。
GitHub City を使う最適なタイミング
公式 contribution graph が正しく、プロフィールやポートフォリオに印象的な可視化を加えたいとき。
トラブルシュートすべきタイミング
city が空、最近の作業がない、非公開 contribution が期待通りに出ないとき。
ルールの最良ソース
カウントルールは GitHub 公式ドキュメントを参照し、このページを実用チェックリストとして使います。
次の内部ステップ
基準が正しくなったら GitHub City のホームページで 3D city を生成します。
FAQ
GitHub contribution graph とは何ですか?
GitHub プロフィールに表示されるカレンダー型の活動チャートです。条件を満たす contribution をまとめますが、すべての commit や操作の生ログではありません。
なぜ GitHub にコミットが表示されませんか?
未接続メール、対象外ブランチ、fork の扱い、非公開設定、リポジトリ条件、更新遅延がよくある原因です。
GitHub Classroom のコミットは表示されますか?
通常の GitHub contribution ルールを満たす場合は表示されます。fork、非公開 repository、対象外 branch では期待通りに表示されないことがあります。
GitHub City は公式 contribution graph の代わりですか?
いいえ。GitHub City は contribution pattern を見せるための visual layer です。活動が数えられたか確認する基準は公式グラフです。
3D graph は非公開 repo 名を表示できますか?
非公開詳細を公開すべきではありません。設定で許可される場合でも、匿名化された contribution count として扱われます。